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Foreword 



This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under www.etsi.org/kev ■ 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document covers the minimum characteristics considered necessary in order to provide comphance to 
GSM 03.19 "SIM API for Java Card ™" [7]. 

The present document describes the technical characteristics and methods of test for testing the SIM API for Java Card 
(tm) [7] implemented in the subscriber identity modules (SIMs) for GSM. It specifies the following parts: 

- test applicabihty 

test environment description 

tests format 

test area reference 

conformance requirements 

test auite files 

test procedure 

test coverage and, 

a description of the associated testing tools that shall be used. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] (void) 

[2] (void) 

[3] GSM 11.11: "Digital cellular telecommunication system (Phase 2+); Specification of the 

Subscriber Identity Module - Mobile Equipment (SIM - ME) interface". 

[4] GSM 1 1.14: "Digital cellular telecommunications system (Phase 2+); 

Specification of the SIM application toolkit for the Subscriber Identity Module - Mobile 
Equipment (SIM - ME) interface". 

[5] GSM 11.17: "Subscriber Identity Module" (SIM) conformance test specification". 

[6] (void) 

[7] GSM 03.19 version 7.4.0: "Digital cellular telecommunications system (Phase 2+); Subscriber 

Identity Module Application Programming Interface (SIM API); SIM API for Java Card''^; 
Stage 2". 

[8] GSM 03.48 version 8.4.0: "Digital cellular telecommunications system (Phase 2+); Security 

Mechanisms for the SIM application toolkit; Stage 2" 
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[9] ISO/IEC 7816-3 (1997) " Identification cards - Integrated circuit(s) cards with contacts, Part 3: 

Electronic signals and transmission protocols" 

[10] GSM 02.19 "Digital cellular telecommunications system (Phase 2+, Release 98); Subscriber 

Identity Module Application Programming Interface (SIM API); Service description; Stage 1" 

[11] S UN J ava Card Specification " J ava Card 2 . 1 API Specification " 

[12] SUN Java Card Specification "Java Card 2.1 Runtime Environment Specification" 

[13] SUN Java Card Specification "Java Card 2.1 VM Architecture Specification" 

[14] ETSI TS 101 220 v3.0.0 "Numbering System for Telecommunication IC card applications" 

[15] GSM 11.10-1: "Digital cellular telecommunication system (Phase 2+); 

Mobile Station (MS) conformance specification; Part 1: Conformance specification". 

3 Definitions and abbreviations 

3.1 Definitions 

The definitions specified in GSM 11.10-1 [15] clause 3.3 shall apply, unless otherwise specified in the present clause. 

Applet: An Applet is an application built up using a number of classes which will run under the control of the Java 
Card virtual machine. 

Applet installation parameters: Default values for applet installation parameters. 

Applet loading script: File containing the APDU commands that will load and install the test applet in the card. 

CleanUp Script file: File containing the APDU commands that will restore the Default Initial Conditions on the SIM 

Conformance Requirement Reference: Description of the expected card behaviour according to 03.19 specification. 

Expected state: the state in which the SIM is supposed to be after the execution of the test procedure applied on the 
relevant initial conditions 

Security parameters: Minimum security requirements defined for the applet installation process. 

Test Area: Set of Test Cases applicable to a specific part ( class method, framework behaviour,...) of the 03.19 
specification. 

Test Case: Elementary test that checks for compliance with one or more Conformance Requirement References. 

Test Output file: TBD. 

Test procedure: the sequence of actions/commands to perform all the test cases defined in a test area. 

Test Script file: File containing the APDU commands that will execute and verify the test results. 

Test Toolkit Applet: Applet designed to test a specific functionality of the SIM API 03.19 specification. 

3.2 Abbreviations 

For the purpose of the present document, the following abbreviations apply, in addition to those listed in 
GSM 01.04 [2]: 

AC Application Code 

AID Application Identifier 

APDU Application Protocol Data Unit 

API Application Programming Interface 

CAD Card Acceptance Device 
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FFS 
IFD 
JCRE 

JVM 
SIM 
SE 



For Further Study 

Interface Device 

Java CardT'^ Run Time Environment 

Java Virtual Machine 

Subscriber Identity Module 

Sending Entity 



4 Test Environment 

This clause specifies requirements that shall be met and the testing rules that shall be followed during the test 
procedure. 



4.1 Applicability 



The tests defined in this specification shall be performed taking into account the services supported by the card as 
specified in the EFsst file. 

This specification contains tests that test interoperability at the API level. This specification does not currently contain 
tests for interoperability at the SIM API framework and at the byte code level. These are for further study. 

The test defined in this specification are applicable to cards implementing TS 03.19 [7] version 7.4.0 unless otherwise 
stated. 



4.2 Test environment description 

The general architecture for the test environment is: 



Scope of the Test Suite. 
. Elements of the Test Suite 




Note; This diagram shows the test architecture required to test interoperabiUty at both API and bytcode level. 
The latter is currently not included in the current specification. The diagram is for information. 
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4.3 Tests format 
4.3.1 Test Area Reference 

Each test area is referenced as follows: 

API Testing;: 'API_[package name]_[classname]_[methodname]' where 
package name: 

sim. access package: '1' 
sim.toolkit package: '2' 
class name: 

yyy: 3 letters for each class. 
See Annex A for full classes acronyms list, 
method name: 

zzzz[input parameters]: 

See Annex A for full methods name acronyms list. 
FWK: framework testing 

[TBD] 
LDR: loader testing 
[TBD] 

4.3.1.1 Conformance requirements 

The conformance requirements are expressed in the following way: 

Method prototype as listed in GSM 03.19 [7] specification. 

Normal execution: 

Contains normal execution and correct parameters limit values, each referenced as a Conformance 
Requirement Reference Normal (CRRN) 

Parameters error: 

Contains parameter errors and incorrect parameter limit values, each referenced as a Conformance 
Requirement Reference Parameter Error (CRRP) 

Context error: 

Contains errors due to the context the method is used in, each referenced as a Conformance Requirement 
Reference Context Error (CRRC) 

4.3.1.2 Test Area files 

The files included in the Test Area use the following naming convention: 

Test Script: [Test Area Reference]_[Test script number]. scr 

Test Applet: [Test Area Reference]_[Test applet number] .Java 

Load Script: [Test Area Reference]_[Load Script number] .Idr 
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Cleanup Script: [Test Area Reference]_[Cleanup Script number]. clr 

The test script, applet, installation parameters, load script, cleanup script and conversion parameters numbers start from 
'1'. 

The test script, load script and cleanup script shall share a common syntax and format (see Annex B). 

Scripts file shall be run in the following order: 

[Test Area Reference]_l .Idr 

[Test Area Reference]_l.scr 

[Test Area Reference]_l.clr 

[Test Area Reference]_2.1dr 

[Test Area Reference]_2.scr 

[Test Area Reference]_2.clr 



[Test Area Reference]_n.ldr 
[Test Area Reference]_n.scr 
[Test Area Reference]_n.clr 
In case that one of the files is not needed, it shall be skipped during the tests execution. 

4.3.1.3 Test Procedure 

Each test procedure contains a table to indicate the expected responses form the API and/or the APDU level as follows: 



Test Case 


Id 


Description 


API Expectation 


APDU Expectation 




Test Case detailed description 


API expected behavior. 


Expected response at APDU 
level. 



4.3.1 .4 Test Coverage 

The table at the end of each test procedure indicates the correspondence between the Conformance Requirements 
Reference (CRR) and the different test cases. 

4.4 Initial Conditions 

The Initial Conditions are a set of general prerequisites for the SIM prior to the execution of testing. For each test 
procedure described in this document, the following rules apply to the Initial Conditions: 

unless otherwise stated, the file system and the files' content shall fulfil the requirements described in the 
"Default Prepersonalisation" paragraph; 

unless otherwise stated, before installing the applet(s) relevant to the current test procedure, all packages specific 
to other test procedures shall not be present. 

When both statements apply, a test procedure is said to be in the "Default Initial Conditions" state. 

4.5 Package name 

Java packages integrating this Test Suite shall follow this naming convention: 
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sim.test.access.[Test Area Reference]: Java Card packages containing Test Area References for the GSM 03.19 
sim.access package. 

sim.test.framework.[Test Area Reference]: Java Card packages containing Test Area References for the GSM 03.19 
framework. 

sim.test.util: for the Test util package defined in this Test Suite. 

sim.test.toolkit.[Test Area Reference]: Java Card packages containing Test Area References for the GSM 03.19[7] 
sim.toolkit package. 

Example: The package ../sim.test.access.[Test Area Reference] creates the following directory structure 

../sim/test/access/[Test Area Reference]/API_l _..._[!. .n].*, where API_l_..._[l..n].'*' are the 
different test applets Java source files used in [Test Area Reference] . 



4.6 AID Coding 



The AID coding for the API Test Packages, Applet classes and Applet shall be as specified in TS 101 220 [14]. In 
addition, the following TAR values are defined for use within the present document: 

TAR Coding (3 bytes/ 24 bits): 



bl 


b2 


b3 


b4 


b5 


b6 : :b21 


b22 


b23 


b24 









































Specific Test Applet Name 



Test Package Identifier 



Test package Identifier( bits bl-b3): 

000 reserved (as TAR= '00.00.00' is reserved for Card Manager) 

001 API 

010 Framework 
Oil Loader 
111 sim.test.util 
other values are RFU 

Specific applet test name (bits b4-b24): 



b4 



b5 



b6 



b7 



b8 



b9 



blO 



bll 



bl2 



bl3 



bl4 



bl5 



hl6 



bl7 



bl8 



bl9 



b20 



b21 



b22 



b23 



b24 



Applet instance 
Number 

Applet Class Number 

Method 

Class 

API Test Package 



for API test package(3 bits) 
001 sim.access 
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010 sim. toolkit 

other are RFU 

Class (5 bits): need to be assigned specification order see Annex A for the full list 

Method (6 bits): need to be assigned specification order see Annex A for the full list 

Applet Class number (5 bits): linked to Test Area, it shall start with 1 for classes and shall be for package. 

Applet Instance number (2 bits) defined in the test procedure it shall start with 01 for applet instance and shall 
be for package and class. 

Application Provider specific data (1 byte): 

'00' for Package 

'Or for Applet class 

'02' for Applet Instance 

For example, the AID of Package sim.test.util is 'AO 00 00 00 09 00 02 FF FF FF FF 89 EO 00 00 00' 

4.7 Test Equipment 

These subclauses recommend a minimum specification for each of the items of test equipment referenced in the tests. 

4.7.1 APDUtool 

This test tool shall meet the following requirements: 

be able to send command to the card TPDU; 

be able to check none, only a part, or all of the data returned; 

be able to check none, only part, or all of the status returned; 

be able to accept all valid status codes returned; 

be able to support Reader commands; 

be able to generate a log file for each test execution. 

if more data is returned than defined in the test specification, the tool shall continue; 

if less data is returned than defined in the test specification, the tool shall aborts and return an error; 

if there is an error in data or status returned, the tool shall abort and return an error. 
The log file produced by the test tool shall include the following information: 

all commands issued; 

all data returned; 

all status returned; 

all errors codes; 

expected data and status in case of error; 

comments from the scripts; 

a log message to report success or failure of the test. 
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Annex D includes Java source code for the sim.test.util package as well as loading , testing and cleaning script 
examples. 



4.7.3 Applet installation parameters 



4.7.3.1 Security parameters 

Loading scripts shall use the following security parameters as stated in GSM 03.48 [8] for applet installation: 



Parameter 


Value in hexadecimal 


SPI 


OAOO 


KIC 


00 


KID 


11 


TAR 


00 00 00 


CNTR 


00 00 00 00 01 


PCNTR 


00 


Key 


01 23 45 67 89 AB CD EF 



4.7.3.2 



Loading components 



Cap files in loading scripts shall not include the descriptor component as described in Java Card 2.1 VM Architecture 
Specification [13]. 



4.8 Testing methodology 



4.8.1 Test interfaces and facilities 

The SIM-ME interface provides the main transport interface for the purpose of performing conformance tests. 
The SIM API interface provides the main test interface for the purpose of performing conformance tests. 



Test plan 



The test plan is divided according to the SIM API specification, that way the tests will follow the class hierarchy for the 
sim.toolkit and sim.access package; for the SIM Toolkit framework this test plan describes the different points that will 
be tested with the present test specification. 



6 API Test Plan 

6.1 Package sim.access: 
6.1.1 Interface SIMView 

Note: The Test applet shall be run on a class that implements this interface. 

6.1.1.1 Constants 

Test Area Reference: API 1 SVW CONST 
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6.1.1.1.1 Conformance Requirements 

This section does not describe the conformance requirements for a method, but rather for the constants of the interface. 

Normal execution 

CRRNl: The constants shall have the same name and value that is defined in GSM 03.19 [7]. 

6.1.1.1.2 Test Suite Files 
None. 

6.1.1.1.3 Test Procedure 

The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.1 .1 .2 Method select(short fid, byteQ fci, short fciOffset, short fciLength) 

Test Area Reference: API_1_SVW_ SLCTS_BSS 

6.1.1.2.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public short select (short fid, 
byte [ ] fci, 
short fciOffset, 
short fciLength) 
throws Java. lang.NullPointerException, 

Java . lang . Array I ndexOut Of Bounds Except ion, 
SIMViewException 

Normal execution 

CRRNl: If the desired file is selected, the length of the FCI (File Control Information) which has been written to the 
array fci is returned. 

CRRN2: If the length fciLength is greater than or equal to the length of the FCI structure, the whole FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

CRRN3: If the length fciLength is less than the length of the FCI structure, the first part of the FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

CRRN4: After selecting a DF/MF no EF is selected. 

CRRN5: After selecting a linear fixed EF no record is selected. 

CRRN6: After selecting a cyclic EF the first record which is the last updated record is selected. 

CRRN7: The current files (file context) of any other applets shall not be changed. See GSM 03.19 [7] - §5.2. This 
will be tested during the testing of the framework. 

CRRN8: The information returned by fci shall be formatted as described in GSM 11.11 [3], §9.2. 1 . 

CRRN9: The file with a File-ID that matches fid shall be found according to the following selection rules: 

1) An immediate child EF or DF of the current MF/DF can be selected, 

2) A sibling DF of the current DF can be selected, 

3) The current MF/DF it self can be selected, 

4) The parent MF/DF of the current DF can be selected. 
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5) The MF can always be selected. 

Parameter errors 

CRRPl: If the array fci is null, an instance of NullPointerException shall be thrown. 

CRRP2: If fciOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: If fciLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP4: If fciOffset plus fciLength is greater than the length of the array fci. length, or fciOffset equals fci.length, an 
instance of ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRCl: If the file with a File-ID which matches fid could not be found according to the selection rules listed in 
CRRN9, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.FILE_NOT_FOUND. 

CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.2.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 

Test Script: API_l_SVW_SLCTS_BSS_l.scr 

Test Applet: API_l_SVW_SLCTS_BSS_l.java 

Load Script: API_l_SVW_SLCTS_BSS_l.ldr 

Cleanup Script: API_l_SVW_SLCTS_BSS_Lclr 
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6.1.1.2.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


Select EFICCID in MF (Transparent EF) 

fid = SIMView.FID_EF_ICCID 
byte[] fci = new byte [34] 
fciOffset = 
fciLength = 20 
select ( ) 


No exception sliall be thrown. 
Shall return a value not greater 
than 20. 

<Description of fci: 

XX XX 

XX XX 

2FE2 

04 

> 




2 


Select EFicciD in MF (Transparent EF) 

fid = SIMView.FID_EF_ICCID 
fciOffset = 
fciLength = 13 
select ( ) 


No exception shall be thrown. 
Shall return 13. 

fci shall contain the first 13 bytes of 
the FCI structure. 




3 


Select DFgsm in MF 

fid = SIMView.FID_DF_GSM 
fciOffset = 
fciLength = 7 
select ( ) 


No exception shall be thrown. 

Shall return 7. 

fci shall contain the entire FCI 

structure. 

<Description of fci: 

XX XX 
XX XX 
7F 20 
02 
> 




4 


Select EFacm in DFqsm (CyclicEF) 

fid = SIMView.FID_EF_ACM 
fciOffset = 
fciLength = 20 
select 


No exception shall be thrown. 
Shall return a value between 15 
and 20. (Cyclic EF) 
fci shall contain the first 15 or more 
bytes of the FCI structure. 
fci[14] shall have the value 3 
(length of record). 




5 


Select MF 

fid = SIMView.FID_MF 
fciOffset = 
fciLength = 34 
select 


No exception shall be thrown. 

Shall return a value between 22 

and 34. 

fci shall contain the entire FCI 

structure. 




6 


Select DFtelecom in MF 

fid = SIMView.FID_DF_TELECOM 
fci[0] = fci[l] = '05' 
fciOffset = 2 
fciLength = 20 
select ( ) 


No exception shall be thrown. 
Shall return 20. 

fci shall contain the first 20 bytes of 
the FCI structure starting at index 
2. The first two bytes shall (still) 
have the value '05'. 




7 


Select EFfdn in DFtelecom (Linear FixedEF) 

fid = SIMView.FID_EF_FDN 
fciOffset = 
fciLength = 15 
select 


No exception shall be thrown. 

Shall return 15. 

fci shall contain the first 15 bytes of 

the FCI structure. 

fci[14] shall have the value 28 

(length of record). 




8 


fci is null 

fid = SIMView.FID_EF_FDN 
byte[] nullBuffer = null 
fciOffset = 
fciLength = 15 
select ( ) 


Shall throw 
java.lang.NullPointerException. 




9 


fciOffset < 

fid = SIMView.FID_EF_FDN 
fciOffset = -1 
fciLength = 15 
select ( ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




10 


fciLength < 

fid = SIMView.FID_EF_FDN 
fciOffset = 
fciLength = -1 
select ( ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




11 


fciOffset + fciLength > fci. length 


Shall throw 
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Id 


Description 


API Expectation 


APDU Expectation 




fid = SIMView.FID_EF_FDN 
fciOffset = 20 
fciLength = 15 
select 


java.lang.ArraylndexOutOfBoundsE 
xception. 




12 


fciOffset >= fci. length 

fid = SIMView.FID_EF_FDN 
fciOffset = 34 
fciLength = 1 
select 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception 




13 


Selection possibilities 

1 - fid = SIMView.FID_MF 
fciOffset = 
fciLength = 15 

select 

2 - fid = SIMView.FID_DF_TELECOM 
select 

3 - fid = SIMView.FID_DF_GRAPHICS 
select ( ) 

4 - fid = SIMView.FID_DF_TELECOM 
select ( ) 

5 - fid = SIMView.FID_DF_GRAPHICS 
select ( ) 

6 - fid = SIMView.FID„MF 
select 

7 - fid = SIMView.FID_DF_GSM 
select 

8 - fid = SIMView.FID_DF_TELECOM 
select ( ) 

9 - fid = SIMView.FID_DF_TELECOM 
select ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - No exception shall be thrown. 

6 - No exception shall be thrown. 

7 - No exception shall be thrown. 

8 - No exception shall be thrown. 

9 - No exception shall be thrown. 




14 


EF not selected after MF/DF selection 

1 - fid = SIMView.FID_MF 
select ( ) 

fid = SIMView.FID_EF_ICCID 
select ( ) 

2 - fid = SIMView.FID_MF 
select 

readBinary ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIMViewException with 
reason code NO_EF_SELECTED. 




15 


No selection of non-reachable file 

1 - fid = SIMView.FID_MF 
select ( ) 

2 - fid = SIMView.FID_EF_ACM 
select 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code FILE_NOT_FOUND. 




16 


No record is selected after selecting linear 
fixed EF 

1 - fid = SIMView.FID_MF 
select 

2 - fid = FID_DF_SIMTEST 
select 

3 - fid = FID_EF_LARU 
select ( ) 

4 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 
4 -Shall throw 

sim. access. SIIVIViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 




17 


Record pointer in selected cyclic EF 

1 - fid = SIMView.FID_MF 
select ( ) 

2 - fid = FID_DF_SIMTEST 
select ( ) 

3 - fid = FID_EF_CARU 
select 

4 - byte[] datal = { 1,2,3 } 
mode = REC_ACC_MODE_PREVIOUS 
updateRecord (datal) 

5 - fid = SIMView.FID_EF_ACM 
select ( ) 

readRecord (data2) 
compare datal to data2 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - The contents of datal and data2 
shall be identical. 
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6.1.1.2.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


1-7 


N2 


3,5 


N3 


1,2,4,6,7 


N4 


14 


N5 


16 


N6 


17 


N8 


1,3 


N9 


1-7, 13 


P1 


8 


P2 


9 


P3 


10 


P4 


11, 12 


C1 


15 


C2, C3 


Not Tested 



6.1.1.3 Method select (short fid) 

Test Area Reference: API_1_SVW_SLCTS 

6.1.1.3.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void select (short fid) 

throws SIMViewException 

Normal execution 

CRRNl: If the desired file is selected, no exception is thrown. 

CRRN2: After selecting a DF/MF no EF is selected. 

CRRN3: After selecting a linear fixed EF no record is selected. 

CRRN4: After selecting a cyclic EF the first record which is the last updated record is selected. 

CRRN5: The current files (file context) of any other applets shall not be changed [03. 19 - §5.2]. This will be tested 
during the testing of the framework. 

CRRN6: The file with a File-ID that matches fid shall be found according to the following selection rules: 

1) An immediate child EF or DF of the current MF/DF can be selected, 

2) A sibling DF of the current DF can be selected, 

3) The current MF/DF it self can be selected, 

4) The parent MF/DF of the current DF can be selected, 

5) The MF can always be selected. 

Parameter errors 
No requirements. 

Context errors 

CRRCl: If the file with a File-ID which matches fid could not be found according to the selection rules listed in 
CCRN6, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.FILE_NOT_FOUND. 
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CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.3.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 

Test Script: API_l_SVW_SLCTS_l.scr 

Test Applet: API_l_SVW_SLCTS_l.java 

Load Script: API_l_SVW_SLCTS_l.ldr 

Cleanup Script: API_l_SVW_SLCTS_l.clr 
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6.1.1.3.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


Select EFicciD in MP (Transparent EF) 

fid = SIMView.FID_EF_ICCID 
select 


No exception shall be thrown. 




2 


EF not selected after MF/DF selection 

1 - fid = SIMView.FID_MF 
select ( ) 

fid = SIMView.FID_EF_ICCID 
select 

2 - fid = SIMView.FID_MF 
select 

readBinary ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIMViewException with 
reason code NO_EF_SELECTED. 




3 


No record is selected after selecting linear 
fixed EF 

1 - fid = SIMView.FID_MF 
select ( ) 

2 - fid = FID_DF„SIMTEST 
select ( ) 

3 - fid =FID_EF_LARU 
select 

4 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 
4 -Shall throw 

sim. access. SIIVIViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 




4 


Record pointer in selected cyclic EF 

1 - fid = SIMView.FID_MF 
select 

2 - fid = SIMView.FID_DF_GSM 
select 

3 - fid = SIMView.FID_EF_ACM 
select ( ) 

4 - byte[l datal = { 1,2,3 } 
updateRecord (datal) 

5 - fid = SIMView.FID_EF_ACM 
select 

readRecord (data2 ) 
compare datal to data2 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - The contents of datal and data2 
shall be identical. 




5 


Selection possibilities 

1 - fid = SIMView.FID_MF 
select ( ) 

2 - fid = SIMView.FID_DF_TELECOM 
select 

3 - fid = SIMView.FID_DF_GRAPHICS 
select 

4 - fid = SIMView.FID_DF_TELECOM 
select ( ) 

5 - fid = SIMView.FID_DF_GRAPHICS 
select ( ) 

6 - fid = SIMView.FID_MF 
select 

7 - fid = SIMView.FID_DF_GSM 
select 

8 - fid = SIMView.FID_DF_TELECOM 
select ( ) 

9 - fid = SIMView.FID_DF_TELECOM 
select ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - No exception shall be thrown. 

6 - No exception shall be thrown. 

7 - No exception shall be thrown. 

8 - No exception shall be thrown. 

9 - No exception shall be thrown. 




6 


No selection of unreachable file 

1 - fid = SIMView.FID_MF 
select 

2 - fid = SIMView.FID_EF_ACM 
select ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code FILE_NOT_FOUND. 





6.1.1.3.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


1 


N2 


2 


N3 


3 


N4 


4 


N6 


5 


C1 


6 


C2, C3 


Not Tested 
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6.1.1.4 Method Status 

Test Area Reference: API_1_SVW_STAT_BSS 

6.1.1.4.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public short status (byte [ ] fci, 

short fciOffset, 
short fciLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
SIMViewException 

Normal execution 

CRRN 1 : The FCI (File Control Information) of the current DP (or MF) is returned in the same format as for a 
SELECT command in case of selecting an MF/DF (described in GSM 03.19 [7], §9.2.1). 

CRRN2: If the length fciLength is greater than or equal to the length of the FCI structure, the whole FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

CRRN3: If the length fciLength is less than the length of the FCI structure, the first part of the FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

Parameter errors 

CRRPl: If the array fci is null, an instance of NullPointerException shall be thrown. 

CRRP2: If fciOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: If fciLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP4: If fciOffset plus fciLength is greater than the length of the array fci. length, or fciOffset equals fci. length, an 
instance of ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRC 1 : If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.4.2 Test Suite Files 
Additional requirements for the GSM personalisation: 

Test Script: API_l_SVW_STAT_BSS_l.scr 

Test Applet: API_l_SVW_STAT_BSS_l.java 

Load Script: API_l_SVW_STAT_BSS_l.ldr 

Cleanup Script: API_l_SVW_STAT_BSS_l.cb- 
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6.1.1.4.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


Status of MF 

byte[] fci = new byte [34] 
fciOffset = 
fciLength = 7 
status 


No exception sliall be thrown. 

Shall return 7. 

fci shall contain the entire FCI 

structure. 

<Description of fci: 

XX XX 

XX XX 

3F00 

01 

> 




2 


Status after select EFiccid in MF 

1 - fid = SIMView.FID_DF_GSM 
fciOffset = 

fciLength = 34 
len = select ( ) 

2 - byte[] fci2 = new byte [34] 

len2 = status ( ) 

3 - Compare len and len2 

4 - Compare tine len bytes of fci and fci2 


1 - No exception shall be thrown. 
Shall return a value between 22 
and 34. 

2 - No exception shall be thrown. 
Shall return 22 or more. 

3 - len and Ien2 shall be identical 

4 - fci and fci2 shall be identical 




3 


Status of DFielecom 

1 - fid = SIMView.FID_DF_TELECOM 
select ( ) 

2 - fciOffset = 
fclLengtli = 100 
status 


1 - No exception shall be thrown. 
Shall return a value between 22 
and 34. 

2 - No exception shall be thrown. 
Shall return a value between 22 
and34. 

fci shall contain the entire FCI 
structure (check that returned value 
is equal to 13 plus the "length of 
following data" - fci[12]).FID of the 
returned fci (fci[4:5]) is 
FID_DF_TELECOM. 




4 


Status DFtelecom 

fciOffset = 
fciLength = 7 
status 


No exception shall be thrown. 

Shall return 7. 

fci shall contain the first 7 bytes of 

the FCI structure starting at index 

0. 

FID of the returned fci (fci[4:5]) is 

FID DF TELECOM. 




5 


fci is null 

byte[] nullBuffer = null 
fciOffset = 
fciLength = 34 
status 


Shall throw 
java.lang.NullPointerException. 




6 


fciOffset < 

fciOffset = -1 
fciLength = 34 
status 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




7 


fciLength < 

fciOffset = 
fciLength = -1 
status 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




8 


fciOffset + fciLength > fci. length 

fciOffset = 20 
fciLength = 15 
status 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




9 


fciOffset >= fci. length 

fciOffset = 34 
fciLength = 1 
status 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 
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6.1.1.4.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


1-4 


N2 


2,3 


N3 


1,4 


P1 


5 


P2 


6 


P3 


7 


P4 


8,9 


C1,C2 


Not Tested 



6.1 .1 .5 Method readBinary 

Test Area Reference: API 1 SVW REDBS BSS 



6.1.1.5.1 



Conformance Requirements 



The method with the following header shall be compliant to its definition in the API. 

public short readBinary (short fileOffset, 

byte [ ] resp, 
short respOffset, 
short respLength) 
throws Java . lang.NullPointerException, 

Java. lang. ArraylndexOutOfBoundsException, 
SIMViewException 

Normal execution 

CRRNl: If data can be accessed at the specified offset, the value respOffset plus respLength are returned and the 
data bytes of the currently selected transparent file are returned in resp. 

Parameter errors 

CRRP 1 : If fileOffset is less than 0, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_FILE_BOUNDARIES. 

CRRP2: If fileOffset plus respLength exceeds the length of the file, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.OUT_OF_FILE_BOUND ARIES. 

CRRP3: If the array resp is null, an instance of NullPointerException shall be thrown. 

CRRP4: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP5: If respLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP6: If respOffset plus respLength is greater than the length of the array resp. length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRC 1 : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not transparent, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.FILEJNCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for the reading of an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 
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CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.5.2 Test Suite Files 

Additional requirements for the GSM personalisation: none. 

Test Script: API_l_SVW_REDBS_BSS_l.scr 

Test Applet: API_l_SVW_REDBS_BSS_l.java 

Load Script: API_l_SVW_REDBS_BSS_l.ldr 

Cleanup Script: API_l_SVW_REDBS_BSS_l.clr 



6.1.1.5.3 



Test Procedure 



id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored 




1 


Read from EFICCID in MF (Transparent EF) 

1 - fid = SIMView.FID_EF_ICCID 
select ( ) 

2 - fileOffset = 
byte[] resp = new byte [20] 
resp[0:19] = '55' 
respOffset = 10 
respLength = 10 
readBinary ( ) 


1 - No exception sliall be thrown. 

2 - No exception sliall be thrown. 
Shall return 20. 

resp shall contain the entire 

contents of EFICCID starting at 

index 10. 

<DescrJption of resp: 

55 55 55 55 55 55 55 55 55 55 

OF FF FF FF FF FF FF FF FF FF 

> 




2 


Read from EFICCID in MF 

resp[0:19] = '55' 
fileOffset = 5 
respOffset = 10 
respLength = 5 
readBinary ( ) 


No exception shall be thrown. 

Shall return 15. 

resp shall contain the last 5 bytes 

of EFICCID starting at index 10. 

<Description of resp: 

55 55 55 55 55 55 55 55 55 55 

FF FF FF FF FF 55 55 55 55 55 

> 




3 


Offset into File out of bounds 

fileOffset = -1 
respOffset = 
respLength = 10 
readBinary ( ) 


Shall throw 

sim. access. SIMViewException with 

reason code 

OUT_OF_FILE_BOUNDARIES. 




4 


fileOffset + respLength > EF length 

fileOffset = 9 
respOffset = 
respLength = 2 
readBinary ( ) 


Shall throw 

sim. access. SIIVIViewException with 

reason code 

OUT_OF_FILE_BOUNDARIES. 




5 


resp is null 

byte[] nullBuffer = null 
fileOffset = 
respOffset = 
respLength = 10 
readBinary ( ) 


Shall throw 
java.lang.NullPointerException. 




6 


respOffset < 

fileOffset = 
respOffset = -1 
respLength = 10 
readBinary ( ) 


Shall throw 

java.lang. 

Array IndexOutOfBoundsException. 




7 


respLength < 

fileOffset = 
respOffset = 
respLength = -1 
readBinary ( ) 


Shall throw 

java.lang. 

Array IndexOutOfBoundsException. 





£75/ 



3GPP TS 11.13 version 7.2.0 Release 1998 



27 



ETSI TS 101 955 V7.2.0 (2001-09) 



Id 


Description 


API Expectation 


APDU Expectation 


8 


respOffset + respLength > resp.length 

fileOffset = 
respOffset = 10 
respLength = 11 
readBinary ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




9 


EF is not Transparent 

1 - fid = FID_DF_SIMTEST 
select 

2 - fid = FID_EF_LARU 
select ( ) 

3 - fileOffset = 
respOffset = 
respLength = 1 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

Sim. access. SIIVIViewException with 
reason code 
FILEJNCONSISTENT. 




10 


Access condition not fulfilled 

1 - fid = DFSIMTTEST 
select ( ) 

2 - fid = EFTNR 
select ( ) 

3 - fileOffset = 
respOffset = 
respLength = 1 
readBinary ( ) 


Shall throw 

sim. access. SIMViewException with 

reason code 

AC_NOT_FULFILLED. 




11 


EF is invalidated 

1 - fid = EFTNU 
invalidate ( ) 

2 - readBinary ( ) 

3 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIIVIViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 

3 - No exception shall be thrown. 




12 


No EF selected 

1- fid = SIMView.FID_MF 

select 

2 readBinary ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code NO EF SELECTED. 





6.1.1.5.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


1-2 


PI 


3 


P2 


4 


P3 


5 


P4 


6 


P5 


7 


P6 


8, 


CI 


12 


C2 


9 


C3 


10 


C4 


11 


C5, C6 


Not Tested 



6.1 .1 .6 Method updateBinary 

Test Area Reference: API 1 SVW UPDBS BSS 



6.1.1.6.1 



Conformance Requirements 



The method with the following header shall be compliant to its definition in the API. 

public void updateBinary (short fileOffset, 

byte [ ] data, 
short dataOffset, 
short dataLength) 
throws Java . lang . NullPointerException, 

Java .lang .ArraylndexOutOfBoundsException, 
SIMViewException 
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Normal execution 

CRRNl: The currently selected transparent file is updated starting at fileOffset, with the string of dataLength bytes 
in the array data starting at dataOffset. 

Parameter errors 

CRRP 1 : If fileOffset is less than 0, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_FILE_BOUNDARIES. 

CRRP2: If fileOffset plus dataLength exceeds the length of the file, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.OUT_OF_FILE_BOUND ARIES. 

CRRP3: If the array data is null, an instance of NullPointerException shall be thrown. 

CRRP4: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP5: If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP6: If dataOffset plus dataLength greater than the length of the array data.length an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRCl: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not transparent, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.FILEJNCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for updating of an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.6.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 

Test Script: API_l_SVW_UPDBS_BSS_l.scr 

Test Applet: API_l_SVW_UPDBS_BSS_Ljava 

Load Script: API_l_SVW_UPDBS_BSS_l.ldr 

Cleanup Script: API_l_SVW_UPDBS_BSS_l.clr 
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6.1.1.6.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF selected 

fileOffset = 
byte[] data = new byte [20] 
data[0] = '55' 
dataOffset = 
dataLength = 10 
updateBinary ( ) 


Shall throw 

Sim. access. SIMViewException with 

reason code NO_EF_SELECTED. 




2 


Update Transparent EF 

1 - fid = DFSIMTEST 
select 

2 - fid = EFTARU 
select ( ) 

3 - fileOffset = 3 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 

4 - fileOffset = 3 
respOffset = 
respLength = 1 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 
Data in resp[0] shall be '55'. 




3 


1 - fileOffset = 254 

data[0] = '55' 
data[ll = 'AA' 
data[21 = '66' 
dataOffset = 
dataLength = 3 
updateBinary ( ) 
2 - fileOffset = 254 
respOffset = 
respLength = 3 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 
Data in resp shall be 

resp[0] = '55' 
resp[1] = 'AA' 
resp[2] = '66' 




4 


Offset into File out of bounds 

fileOffset = -1 
dataOffset = 
dataLength = 10 
updateBinary ( ) 


Shall throw 

sim. access. SIMViewException with 

reason code 

OUT_OF_FILE_BOUNDARIES. 




5 


fileOffset + dataLength > EF length 

fileOffset = 259 
dataOffset = 
dataLength = 2 
updateBinary ( ) 


Shall throw 

sim. access. SIIVIViewException with 

reason code 

OUT_OF_FILE_BOUNDARIES. 




6 


data is null 

byte[] nullBuffer = null 
fileOffset = 
dataOffset = 
dataLength = 10 
updateBinary ( ) 


Shall throw 
java.lang.NullPointerException. 




7 


dataOffset < 

fileOffset = 

dataOffset = -1 
dataLength = 10 
updateBinary ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




8 


dataLength < 

fileOffset = 
dataOffset = 
dataLength = -1 
updateBinary ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




9 


dataOffset + dataLength > data.length 

fileOffset = 
dataOffset = 10 
dataLength = 11 
updateBinary ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


EF is not Transparent 

1 - fid = FID_DF_SIMTEST 
select 

2 - fid = FID_EF_LARU 
select ( ) 

3 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

Sim. access. SIIVIViewException with 
reason code 
FILEJNCONSISTENT. 




11 


Access condition not fulfilled 

1 - fid = DFSIMTEST 
select ( ) 

fid = EFTNU 
select 

2 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




12 


EF is invalidated 

1 - fid = EFTNR 
invalidate ( ) 

2 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 

3 - rehabilitate 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 

3 - No exception shall be thrown. 





6.1.1.6.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


2,3 


PI 


4 


P2 


5 


P3 


6 


P4 


7 


P5 


8 


P6 


9 


CI 


1 


C2 


10 


C3 


11 


C4 


12 


C5, C6 


Not Tested 



6.1 .1 .7 Method readRecord 

Test Area Reference: API 1 SVW REDRSBS BSS 



6.1.1.7.1 



Conformance Requirements 



The method with the following header shall be compliant to its definition in the API. 

public short readRecord (short recNumber, 

byte mode, 
short recOffset, 
byte [ ] resp, 
short respOffset, 
short respLength) 
throws Java . lang.NullPointerException, 

Java. lang. ArraylndexOutOfBoundsException, 
SIMViewException 

Normal execution 

CRRNl: The data bytes from the record, specified by mode and recNumber of the currently selected linear fixed or 
cyclic EF, is read at recOffset. A total of respLength bytes of this data is copied to the array resp at respOffset. 
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CRRN2: If the access mode is REC_ACC_MODE_ABSOLUTE_CURRENT: 

if recNumber is not 0, the record addressed by recNumber will be read; 

if recNumber is the current selected record will be read; and 

the current record pointer shall not change. 
CRRN3: If the access mode is REC_ACC_MODE_NEXT: 

the next record relative to the current selected record will be selected and read; 

if no current record is selected, the first record will be selected and read; 

if the current record pointer is set to the last record for a cyclic EF the record pointer is set to the first record 
and the record is read; 

the current record pointer of any other applet shall not be changed. 

CRRN4: If the access mode is REC_ACC_MODE_PREVIOUS: 

the previous record relative to the current selected record will be selected and read; 

if no current record is selected, the last record will be selected and read; 

if the current record pointer is set to the first record, for a linear fixed EF the method responses with an error 
exception and for a cyclic EF the record pointer is set to the last record and the record is read; 

the current record pointer of any other applet shall not be changed. 

Parameter errors 

CRRPl: If the currently selected EF is linear fixed and the access mode is 

REC_ACC_MODE_ABSOLUTE_CURRENT and recNumber is less than or greater than records available, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP2: If the currently selected EF is linear fixed and the access mode is 

REC_ACC_MODE_ABSOLUTE_CURRENT, recNumber is and there is no current record selected, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP3: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP4: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_PREVIOUS and the 
current record pointer is set to the first record, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

CRRP6: If recOffset plus respLength is greater than the record length, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

CRRP7: If the access mode is not between 2 and 4 inclusive (2 = REC_ACC_MODE_NEXT, etc.), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. INVALID_MODE. 

CRRP8: If the array resp is null, an instance of NullPointerException shall be thrown. 

CRRP9: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRPIO: If respLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP 11 ; If respOffset plus respLength is greater than the length of the array resp. length, or respOffset equals 
resp. length, an instance of ArraylndexOutOfBoundsException shall be thrown. 
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Context errors 

CRRC 1 : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.FILE_INCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for reading an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.7.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 

Test Script: API_l_SVW_REDRSBS_BSS_l.scr 

Test Applet: API_l_SVW_REDRSBS_BSS_l.java 

Load Script: API_l_SVW_REDRSBS_BSS_l.ldr 

Cleanup Script: API_l_SVW_REDRSBS_BSS_l.clr 



6.1.1.7.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF selected 


Shall throw 






recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 


Sim. access. SIMViewException with 
reason code NO_EF_SELECTED. 






byte[] resp = new byte [20] 








respOffset = 








respLength = 10 








readRecord ( ) 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Read Absolute and Current from Linear Fixed 
EF 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFLARU 
select 

// Record pointer not set. 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 

4 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 

5 - recNumber = 1 
readRecord ( ) 

6 - recNumber = 

resp[0] = resp[l] = resp[2] = resp[3] = 

'00' 

readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 
resp[3] = 'AA' 

5 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 

6 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 




3 


Read Next from Linear Fixed EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


No exception shall be thrown. 

resp shall be: 

resp[0] = 'AA' 

resp[1] = 'AA' 

resp[2] = 'AA' 

resp[3] = 'AA' 




4 


Read Next from Linear Fixed EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


Shall throw 

Sim. access. SIMViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 




5 


Read Previous from Linear Fixed EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 4 

readRecord ( ) 


No exception shall be thrown. 

resp shall be: 

resp[0] = '55' 

resp[1] = '55' 

resp[2] = '55' 

resp[3] = '55' 




6 


Read Previous from Linear Fixed EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 4 

readRecord ( ) 


Shall throw 

Sim. access. SIMViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Read Absolute and Current from Cyclic EF 

1 - fid = EFCARU 
select 

2 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 

3 - recNumber = 1 
readRecord ( ) 

4 - recNumber = 

resp[0] = resp[l] = resp[2] = '00 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown, 
resp shall be: 

resp[0] = ' AA' 
resp[1] = 'AA' 
resp[2] = ' AA' 

3 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 




8 


Read Next from Cyclic EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 


No exception shall be thrown, 
resp shall be: 
resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 




9 


Read Next from Cyclic EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord () 


No exception shall be thrown, 
resp shall be: 
resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 




10 


Read Previous from Cyclic EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 3 

readRecord ( ) 


No exception shall be thrown, 
resp shall be: 
resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 




11 


Read Previous from Cyclic EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 3 

readRecord ( ) 


No exception shall be thrown, 
resp shall be: 
resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 




12 


Read Absolute from Linear Fixed EF beyond 

Records 

1 - fid = EFLARU 
select 

2 - recNumber = -1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 

3 - recNumber = 3 
readRecord ( ) 


1 - No exceptionshall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 

3 - Shall throw 

sim. access. SIIVIViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 




13 


No current record in linear fixed EF, read 

current 

1 - fid = EFLARU 

select // No curr rec 

2 - recNumber =0 // curr rec 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


recOffset < 

1 - fid = EFLARU 
select 

2 - recNumber =1 // rec 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = -1 
respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIMViewException with 

reason code 

OUT OF RECORD BOUNDARIE 

S. 




15 


recOffset + respLength > Record Length 

1 - fid = EFLARU 
select ( ) 

2 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 2 
respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIIVIViewException with 

reason code 

OUT OF RECORD BOUNDARIE 

S. 




16 


Reading with invalid mode 

1 - fid = EFLARU 
select 

2 - recNumber = 
mode = 1 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 

3 - mode = 5 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID_MODE. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID_MODE. 




17 


resp is null 

byte[] nullBuffer = null 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

respOffset = 

respLength = 10 

readRecord ( ) 


Shall throw 
java.lang.NullPointerException. 




18 


respOffset < 

respOffset = -1 
respLength = 10 
readRecord ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




19 


respLength < 

respOffset = 
respLength = -1 
readRecord () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




20 


respOffset + respLength > resp.length 

respOffset = 10 
respLength = 11 
readRecord () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




21 


EF is neither Cyclic nor Linear Fixed 

1 - fid = DFSIMTEST 
select 

2 - fid = EFTNU 
select 

3 - respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT. 




22 


Access condition not fulfilled 

1 - fid = EFCNR 
select 

2 - respLength = 3 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

AC NOT FULFILLED. 




23 


EF is invalidated 

1 - fid = EFCNU 
invalidate ( ) 

2 - readRecord 

3 - rehabilitate 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 

3 - No exception shall be thrown. 
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6.1.1.7.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


2-5,7-11 


N2 


2,7 


N3 


3,8,9 


N4 


5, 10, 11 


P1 


12 


P2 


13 


P3 


4 


P4 


6 


P5 


14 


P6 


15 


P7 


16 


P8 


17 


P9 


18 


P10 


19 


P11 


20 


C1 


1 


C2 


21 


C3 


22 


C4 


23 


C5, C6 


Not Tested 



6.1 .1 .8 Method update Record 

Test Area Reference: API_1_SVW_UPDRSBS_BSS 

6.1.1.8.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void updateRecord (short recNumber, 

byte mode, 
short recOffset, 
byte [ ] data, 
short dataOffset, 
short dataLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
SIMViewException 

Normal execution 

CRRNl: dataLength bytes of the record specified by mode and recNumber of the current selected linear fixed or 
cyclic EF are updated at recOffset, by using the string of bytes in the array data starting at dataOffset. 

CRRN2: If the access mode is REC_ACC_MODE_ABSOLUTE_CURRENT and the file is a linear fixed EF: 

- the record addressed by recNumber will be updated; 

if recNumber is the current selected record will be updated; and 

the current record pointer shall not change. 
CRRN3: If the access mode is REC_ACC_MODE_NEXT and the file is a linear fixed EF: 

the next record relative to the current selected record will be selected and updated; 

if no current record is selected, the first record will be selected and updated; 

the current record pointer of any other applet shall not be changed. 
CRRN4: If the access mode is REC_ACC_MODE_PREVIOUS: 

the previous record relative to the current selected record will be selected and updated; 
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if no current record is selected, the last record will be selected and updated; 

if a cyclic EF is updated, the oldest record will be updated independent of the current record pointer and this 
record becomes record number 1 and the current record; 

the current record pointer of any other applet shall not be changed in case of a linear fixed EF. 

Parameter errors 

CRRPl: If the currently selected EF is linear fixed and the access mode is 

REC_ACC_MODE_ABSOLUTE_CURRENT and recNumber is less than or greater than records available, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP2: If the currently selected EF is linear fixed and the access mode is 

REC_ACC_MODE_ABSOLUTE_CURRENT, recNumber is and there is no current record selected, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP3: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP4: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_PREVIOUS and the 
current record pointer is set to the first record; an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

CRRP6: If recOffset plus dataLength is greater than the record lengh, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

CRRP7: If the access mode is not between 2 and 4 inclusive (2 = REC_ACC_MODE_NEXT, etc.), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. INVALID_MODE. 

CRRP8: If the currently selected EF is cyclic and the mode of record access mode is not 

REC_ACC_MODE_PREVIOUS, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALID_MODE. 

CRRP9: If the array data is null, an instance of NullPointerException shall be thrown. 

CRRPIO: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRPll: If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRPl 2: If dataOffset plus dataLength, is greater than the length of the array data.length, or dataOffset equals 
data.length, an instance of ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRC 1 : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.FILE_INCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for updating an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 
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CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.8.2 Test Suite Files 

Additional requirements for the GSM personalisation: This test is based on the assumption that the contents of the EFs 
in DFsiMTEST are identical to those defined in the default pre-personalisation and the current record pointers have not 
been altered. 

Test Script: API_l_SVW_UPDRSBS_BSS_l.scr 

Test Applet: API_l_SVW_UPDRSBS_BSS_l.java 

Load Script: API_l_SVW_UPDRSBS_BSS_l.ldr 

Cleanup Script: API_l_SVW_UPDRSBS_BSS_l.clr 
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6.1.1.8.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF selected 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 

byte[] data = new byte [20] 

dataOffset = 

dataLength = 10 

updateRecord ( ) 


Shall throw 

Sim. access. SIIVIViewException with 

reason code NO_EF_SELECTED. 




2 


Update Absolute and Current from Linear 
Fixed EF 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFLARU 
select 

// Record pointer not set. 

3 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

data [0:3] = '11' 

recOffset = 

dataOffset = 

dataLength = 4 

updateRecord ( ) 

respOffset = 

respLength = 

readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 
Resp shall be: 

Resp[0] = '11' 
Resp[1] = '11' 
Resp[2] = '11' 
Resp[3] = '11' 


= 4 


3 


Update Current from Linear Fixed EF 

1 - fid = DFSIMTEST 
select 

2 - fid = EFLARU 
select ( ) 

// Set record pointer with mode "next". 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 

data[0:3] = "00' 

dataOffset = 

dataLength = 4 

updateRecord () 

// write data with mode "current" 

4 - recNumber = 
data[0:3] = '22' 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

updateRecord ( ) 

// read result with mode "absolute" 

respOffset = 

respLength = 4 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = '22' 
resp[1] = '22' 
resp[2] = '22' 
resp[3] = '22' 




4 


Update Next from Linear Fixed EF, no record 
pointer set 

1 - fid = FID_DF_SIMTEST 
select ( ) 

2 - fid = FID_EF_LARU 
select 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 

data[0:3] = '33' 

dataOffset = respOffset = 

dataLength = respLength = 4 

updateRecord ( ) 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

readRecord () 


1 - No exception shall be thrown. 
2- No exception shall be thrown. 
3 - No exception shall be thrown. 
Resp shall be: 
Resp[0] = '33' 
Resp[1] = '33' 
Resp[2] = '33' 
Resp[3] = '33' 




5 


Update Next from Linear Fixed EF, record 
pointer set 

1 - recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:3] = M4' 


1 - No exception shall be thrown. 

2 - No exception shall be thrown, 
resp shall be: 

resp[0] = '44' 
resp[1] = '44' 
resp[2] = '44' 
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Id 


Description 


API Expectation 


APDU Expectation 




dataOffset = 

dataLength = 4 

updateRecord () 

2 - mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

readRecord ( ) 


resp[3] = '44' 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


Update Next from Linear Fixed EF, no more 


Shall throw 






records 


sim. access. SIMViewException with 






recNumber = 


reason code 






mode = REC_ACC_MODE_NEXT 


RECORD NUMBER NOT AVAIL 






recOffset = 


ABLE. 






data[0:3] = '55' 








dataOffset = 








dataLength = 4 








updateRecord ( ) 






7 


Update Previous from Linear Fixed EF, no 


1 - No exception shall be thrown. 






record pointer set 


2 - No exception shall be thrown. 






1 - fid = DFSIMTEST 


3 - No exception shall be thrown. 






select ( ) 


4 - No exception shall be thrown. 






2 - fid = EFLARU 


resp shall be: 






select ( ) 

3 - recNumber = 


resp[0] = '66' 






mode = REC„ACC_MODE_PREVIOUS 


resp[1] = '66' 






recOffset = 


resp[2] = '66' 






data[0:3] = "66' 


resp[3] = '66' 






dataOffset = respOffset = 








dataLength = respLength = 4 








updateRecord ( ) 








4 - mode = REC_ACC_MODE_ABSOLUTE_CURRENT 








readRecord ( ) 






8 


Update Previous from Linear Fixed EF, record 


1 - No exception shall be thrown 






pointer set 


2 - No exception shall be thrown. 






1 - recNumber = 


Resp shall be: 






mode = REC_ACC_MODE_PREVIOUS 


Resp[0] = '7744' 






recOffset = 
data[0:3] = '77' 
dataOffset = respOffset = 


Resp[1] = '7744' 
Resp[2] = '7744' 






dataLength = respLength = 4 


Resp[3] = '7744' 






updateRecord ( ) 








readRecord ( ) 








2 - mode = REC_ACC_MODE_ABSOLUTE_CURRENT 






9 


Update Previous from Linear Fixed EF , no 


Shall throw 






more records 


sim. access. SIIVIViewException with 






recNumber = 


reason code 






mode = REC_ACC_MODE_PREVIOUS 


RECORD NUMBER NOT AVAIL 






recOffset = 


ABLE. 






data [0:3] = '88' 








dataOffset = respOffset = 








dataLength = respLength = 4 








updateRecord ( ) 






10 


Update Previous from Cyclic EF 


1 - No exception shall be thrown. 






1 - fid = FID_DF_SIMTEST 


2 - No exception shall be thrown. 






select 


3 - No exception shall be thrown. 






2 - fid = FID_EF_CARU 
select 

3 — recNumber = 2 


4 - No exception shall be thrown. 






5 - No exception shall be thrown. 






mode = REC_ACC_MODE_ABSOLUTE_CURRENT 


resp shall be: 






recOffset = 


resp[0] = data[0] 






respOffset = 


resp[1] = data[1] 






respLength = 3 


resp[2] = data[2] 






readRecord ( ) 








4 - recNumber = 2 








mode = REC_ACC_MODE_PREVIOUS 








data[0:2] = resp[0:2] " 'FF' 








dataOffset = 








dataLength = 3 








updateRecord ( ) 








5 - recNumber = 








mode = REC_ACC_MODE_ABSOLUTE_CURRENT 








respOffset = 








respLength = 3 








readRecord ( ) 






11 


Update Absolute from Linear Fixed EF beyond 


1 - No exception shall be thrown. 






Records 


2 - Shall throw 






1 - fid = EFLARU 


sim. access. SIMViewException with 






select 


reason code 






2 -recNumber = -1 


RECORD_NUMBER_NOT_AVAIL 






mode = REC_ACC_MODE_ABSOLUTE_CURRENT 










ABLE. 






recOffset = 








dataOffset = 


3 - Shall throw 






dataLength = 4 


sim. access. SIMViewException with 
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Id 


Description 


API Expectation 


APDU Expectation 




updateRecord ( ) 

2 - recNumber = 3 

updateRecord ( ) 


reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


No current record in linear fixed EF, update 
current 

1 - fid = EFLARU 

select // No curr rec 

2 - recNumber =0 // curr rec 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
dataOffset = 
dataLength = 4 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIMViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 




13 


recOffset < 

1 - fid = EFLARU 
select 

2 - recNumber =1 // rec 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = -1 
dataOffset = 
dataLength = 4 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

OUT OF RECORD BOUNDARIE 

S. 




14 


recOffset + dataLength > Record Length 

1 - fid = EFLARU 
select ( ) 

2 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 2 
dataOffset = 
dataLength = 4 
updateRecord 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

OUT OF RECORD BOUNDARIE 

S. 




15 


Updating with invalid mode 

1 - fid = EFLARU 
select ( ) 

2 - recNumber = 
mode = 1 
recOffset = 
dataOffset = 
dataLength = 4 
updateRecord ( ) 

3 - mode = 5 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID MODE. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID_MODE. 




16 


Updating Cyclic EF with invalid mode 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFCARU 
select ( ) 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:2] = '00' 
dataOffset = 
dataLength = 3 
updateRecord ( ) 

4 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
updateRecord ( ) 

5 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
updateRecord 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID_MODE. 

4 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID_MODE. 

5 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID_MODE. 




17 


data is null 

byte[] nullBuffer = null 
dataOffset = 
dataLength = 10 
updateRecord ( ) 


Shall throw 
java.lang.NullPointerException. 




18 


dataOffset < 

dataOffset = -1 
dataLength = 10 
updateRecord ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




19 


dataLength < 

dataOffset = 
dataLength = -1 
updateRecord ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




20 


dataOffset + dataLength > data.length 

dataOffset = 10 
dataLength = 11 
updateRecord ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




21 


EF is neither Cyclic nor Linear Fixed 


1 - No exception shall be thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 




1 - fid = DFSIMTEST 
select 

2 - fid = EFTNR 
select 

3 - dataOffset = 
dataLength = 4 
updateRecord ( ) 


2 - No exception shall be thrown. 

3 - Shall throw 

Sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT. 




22 


Access condition not fulfilled 

1 - fid = EFCNU 
select 

2 - recOffset = 
dataOffset = 
dataLength = 1 

mode = REC_ACC_MODE_PREVIOUS 
updateRecord ( ) 

3 - fid = EFLNU 
select 

4 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
dataOffset = 
dataLength = 1 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIIVIViewException with 
reason code 
AC_NOT_FULFILLED. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim. access. SIIVIViewException with 
reason code 
AC_NOT_FULFILLED. 




23 


EF is invalidated 

1 - fid = EFCNR 
invalidate ( ) 

2 - updateRecord ( ) 

3 - rehabilitate 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 

3 - No exception shall be thrown. 





6.1.1.8.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


2,3,4,5,7,8, 10 


N2 


2,3 


N3 


5,6 


N4 


7,8,9, 10 


P1 


11 


P2 


12 


P3 


6 


P4 


9 


P5 


13 


P6 


14 


P7 


15 


P8 


16 


P9 


17 


P10 


18 


P11 


19 


P12 


20 


C1 


1 


C2 


21 


C3 


22 


C4 


23 


C5, C6 


Not Tested 



6.1.1.9 Method seek 

Test Area Reference: API_1_SVW_SEEKB_BSS 

6.1.1.9.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public short seek (byte mode, 

byte[l patt. 



£75/ 



3GPP TS 1 1 .1 3 version 7.2.0 Release 1 998 45 ETSI TS 1 01 955 V7.2.0 (2001 -09) 

short pattOffset, 
short pattLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array IndexOutOfBoundsExcept ion, 
SIMViewException 

Normal execution 

CRRNl: If the pattern in patt with the length pattLength at offset pattOffset is found in the record being specified by 
mode, the current record pointer is set to that record and the record number is returned. The record pointer of any 
other applet is not changed. This will be tested during the testing of the framework. 

CRRN2: If mode is SEEK_FROM_BEGINNING_FORWARD, the search starts with the first record forward 
towards the end of the file. 

CRRN3: If mode is SEEK_FROM_END_BACKWARD, the search starts with the last record backward towards the 
beginning of the file. 

CRRN4: If mode is SEEK_FROM_NEXT_FORWARD, the search starts from the next record after the current 
record pointer forward towards the end of file. If no current record pointer is selected, the search starts with the 
first record. 

CRRN5: If mode is SEEK_FROM_PREVIOUS_BACKWARD, the search starts from the previous record before 
the current record pointer backward towards the beginning of the file. If no current record pointer is selected the 
search starts with the last record. 

CRRN6: If pattern in patt is not found, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.PATTERN_NOT_FOUND. 

CRRN7: If mode is SEEK_FROM_NEXT_FORWARD and the record pointer is at the last record, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.PATTERN_NOT_FOUND. 

CRRN8: If mode is SEEK_FROM_PREVIOUS_BACKWARD and the record pointer is at the first record, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.PATTERN_NOT_FOUND. 

Parameter errors 

CRRPl: If mode is not between and 3 inclusive (0 = SEEK_FROM_BEGINNING_FORWARD, etc.), an instance 
of SIMViewException shall be thrown. The reason code shall be SIMViewException.INVALID_MODE. 

CRRP2: If the pattern array patt is null, an instance of NullPointerException shall be thrown. 

CRRP3: If pattOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP4: If pattLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP5: If pattLength is greater than the size of the record of the currently selected EF, an instance of 
SIMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

CRRP6: If pattOffset plus pattLength is greater than the length of the pattern array patt.length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRCl: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not linear fixed, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.FILEJNCONSISTENT. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 
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CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for reading an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.9.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.1.1.9.3 



API_l_SVW_SEEKB_BSS_l.scr 
API_l_SVW_SEEKB_BSS_l.java 
API_l_SVW_SEEKB_BSS_l.ldr 
API_l_SVW_SEEKB_BSS_l.ldr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF selected 

Byte[] patt = new byte [20] 

pattOffset = 

pattLength = 10 

mode = SEEK_FROM_BEGINNING_FORWARD 

seekO 


Shall throw 

Sim. access. SIMViewException with 

reason code NO_EF_SELECTED. 




2 


Pattern not Found 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFLARU 
select 

3 - patt [0] = 'DA' 
pattOffset = 
pattLength = 1 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 

reason code 

PA! 1 bRN_NOT_FOUND. 




3 


Seek from Beginning Forward 

patt[0:2] = '55' 

pattOffset = 

pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 

seek ( ) 


No exception shall be thrown. Shall 
return 1 




4 


Seek from End Backward 

patt[0:21 = '55' 

pattOffset = 

pattLength = 3 

mode = SEEK_FROM_END_BACKWARD 

seek ( ) 


No exception shall be thrown. Shall 
return 1 




5 


Seek from Next Forward 

patt [0:2] = 'AA' 

pattOffset = 

pattLength = 3 

mode = SEEK_FROM_NEXT_FORWARD 

seek ( ) 


No exception shall be thrown. Shall 
return 2 




6 


Last Record, Seek from Next Forward 

mode = SEEK_FROM_NEXT_FORWARD 
seekO 


Shall throw 

sim. access. SIMViewException with 

reason code 

PAI IbRN NOT FOUND. 




7 


Seek from Previous Backward 

patt[0:2] = '55' 

pattOffset = 

pattLength = 3 

mode = SEEK_FROM_PREVIOUS_BACKWARD 

seek ( ) 


No exception shall be thrown. Shall 
return 1 




8 


First Record, Seek from Previous Backward 


Shall throw 
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Id 


Description 


API Expectation 


APDU Expectation 




SEEK_FROM_PREVIOUS_BACKWARD 
seekO 


Sim. access. SIMViewException with 

reason code 

PA! IbRN NOT FOUND. 




9 


Pattern not Found (out of reach) 

patt[0:2] = '55' 

pattOffset = 

pattLength = 3 

mode = SEEK_FROM_NEXT_FORWARD 

seekO 


Shall throw 

sim. access. SIIVIViewException with 

reason code 

PA! 1 bRN_NOT_FOUND. 




10 


Invalid mode 

1 - mode = 4 
seek ( ) 

2 - mode = -1 
seek ( ) 


1 - Shall throw 

sim. access. SIIVIViewException with 
reason code INVALID IVIODE 

2 - Shall throw 

sim. access. SIIVIViewException with 
reason code INVALID MODE 




11 


patt is null 

byte[] nullBuffer = null 

mode = SEEK_FROM_BEGINNING_FORWARD 

seek 


Shall throw 
java.lang.NullPointerException. 




12 


pattOffset < 

patt[0:2] = '55' 

pattOffset = -1 

pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 

seekO 


Shall throw 

java.lang. 

Array IndexOutOfBoundsException 




13 


pattLength < 

patt[0:2] = '55' 

pattOffset = 

pattLength = -1 

mode = SEEK_FROM_BEGINNING_FORWARD 

seekO 


Shall throw 

java.lang. 

Array IndexOutOfBoundsException 




14 


pattLength > size of record 

patt[0:4] = '55' 

pattOffset = 

pattLength = 4 

mode = SEEK_FROM_BEGINNING_FORWARD 

seekO 


Shall throw 

sim. access. SIMViewException with 

reason code 

OUT OF RECORD BOUNDARIE 

S 




15 


pattOffset + pattLength > patt.length 

patt[0:2] = '55' 

pattOffset = 1 

pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 

seekO 


Shall throw 

java.lang. 

Array IndexOutOfBoundsException 




16 


EF is not Linear Fixed 

1 - fid = EFTNU 
select 

2 - pattOffset = 
pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 

3 - fid = EFCNU 
select ( ) 

seek ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT 

3 - Shall throw 

sim. access. SIMViewException with 

reason code 

FILE INCONSISTENT 




17 


Access condition not fulfilled 

1 - fid = EFLNR 
select 

2 - patt [0] = '55' 
pattOffset = 
pattLength = 1 

mode = SEEK„FROM_BEGINNING_FORWARD 
seek ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




18 


EF is invalidated 

1 - fid = EFLARU 
select 

2 - invalidate () 

3 - patt [0] = '55 
pattOffset = 
pattLength = 1 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 

4 - rehabilitate 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 

4 - No exception shall be thrown. 
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6.1.1.9.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


2,3-6,7 


N2 


3 


N3 


4 


N4 


5 


N5 


7 


N6 


2,6,8,9 


N7 


6 


N8 


8 


P1 


10 


P2 


11 


P3 


12 


P4 


13 


P5 


14 


P6 


15 


C1 


1 


C2 


16 


C3 


17 


C4 


18 


C5, C6 


Not Tested 



6.1.1.10 Method increase 

Test Area Reference: API_1_SVW_INCR_BS_BS 



6.1.1.10.1 



Conformance Requirements 



The method with the following header shall be compliant to its definition in the API. 

public short increase (byte [ ] incr, 

short incrOffset, 
byte [ 1 resp, 
short respOffset) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
SIMViewException 



Normal execution 



CRRNl: The value in the array incr is added to the value of the last increased / updated record in the currently 
selected cyclic EF. The result is stored in the oldest record and returned in the array resp. The updated record 
becomes record number 1 and is selected as current record. The number of bytes of valid data in resp is returned. 

Parameter errors 

CRRPl: If the array incr is null, an instance of NullPointerException shall be thrown. 

CRRP2: If incrOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: If incrOffset plus the value 3, is greater than the length of the array incr.length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP4: If the result of the addition is greater than the maximum value of the record (represented by all bytes set to 
'FF'), an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.MAX_VALUE_REACHED. 

CRRP5: If the array resp is null, an instance of NullPointerException shall be thrown. 

CRRP6: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP7: If the remaining length of the array resp at the offset respOffset is less than the length of the record, an 
instance of ArraylndexOutOfBoundsException shall be thrown. 
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Context errors 

CRRC 1 : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not cyclic, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.FILE_INCONSISTENT. 

CRRC3: If increase is not allowed as indicated by the FCIbyte 8 (GSM 11.11: FCI structure of an EF returned by 
the SELECT command), an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.FILE_INCONSISTENT. 

CRRC4: If the calling applet does not fulfil the access condition, INCREASE, to perform this function, an instance 
of SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

CRRC5: If the currently selected EF is invalidated, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC6: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC7: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.10.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 

Test Script: API_l_SVW_INCR_BS_BS_l.scr 

Test Applet: API_l_SVW_INCR_BS_BS_l.java 

Load Script: API_l_SVW_INCR_BS_BS_l.ldr 

Cleanup Script: API_l_SVW_INCR_BS_BS_l.clr 



6.1.1.10.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF selected 

byte[] incr = new byte [4] 
byte[] resp = new byte [4] 
incrOffset = 
respOffset = 
increase ( ) 


Shall throw 

sim. access. SIIVIViewException with 

reason code NO_EF_SELECTED. 




2 


Increase , verify response 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFCARU 
select ( ) 

3 - //Set both records to 00 00 00 
mode = REC_ACC_MODE_PREVIOUS 

data [0:3] = 
dataOffset = 
dataLength = 3 
updateRecord ( ) 
updateRecord ( ) 

4 - incrOffset = 
incr[2] = 1 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 
resp[] shall contain {0,0,1 ,0}. 




3 


Increase, verify file 

1 - incrOffset = 1 
incr[2] = 0, incr[3] = 2 
respOffset = 1 
increase ( ) 

2 - resp[3] = 
recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 


1 - No exception shall be thrown. 
respG shall contain {0,0,0,3}. 

2 - No exception shall be thrown. 
respG shall contain {0,0,3,0}. 
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Id 


Description 


API Expectation 


APDU Expectation 




recOffset = 
respOffset = 
respLength = 
readRecord ( ) 






4 


incr is null 

byte[] nullBuffer = null 
incrOffset = 
respOffset = 
increase ( ) 


Shall throw 
java.lang.NullPointerException. 




5 


incrOffset < 

incrOffset = -1 
respOffset = 
increase ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




6 


incrOffset + 3 > incr.length 

incrOffset = 2 
respOffset = 
increase ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




7 


Reach Maximum Value 

incr[0] = incr[l] = incr[2] = ' FF ' 
incrOffset = 
respOffset = 
increase ( ) 


Shall throw 

Sim. access. SIMViewException with 

reason code 

MAX_VALUE_REACHED. 




8 


resp is null 

incr[0] = incr[l] = 0x00' 

incr[2] = '02' 

incrOffset = 

byte[] respNull = null 

respOffset = 

increase ( ) 


Shall throw 
Java.lang.NullPointerException. 




9 


respOffset < 

incrOffset = 
respOffset = -1 
increase ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




10 


respOffset + recordLength > resp.length 

incrOffset = 
respOffset = 2 
increase ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




11 


EF is not Cyclic 

1 - fid = EFTARU 
select ( ) 

2 - incrOffset = 
respOffset = 
increase ( ) 

3 - fid = EFLARU 
select 

4 - incrOffset = 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIIVIViewException with 
reason code 
FILEJNCONSISTENT. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim. access. SIMViewException with 

reason code 

FILE INCONSISTENT. 




12 


Access condition not fulfilled 

1 - fid = EFCNIC 
select 

2 - incrOffset = 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIIVIViewException with 
reason code 
AC_NOT_FULFILLED. 




13 


EF is invalidated 

1 - fid = EFCARU 
select 

2 - invalidate () 

3 - incrOffset = 
respOffset = 
increase ( ) 

4 - rehabilitate 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADIGTION. 

4 - No exception shall be thrown. 




14 


Check increase not allowed from FCI 

1 - fciOffset = 
fciLength = 8 

select (FID_EF_CINA, fci...) 
Verify FCI byte 8 (fci [7]) 

2 - incrOffset = 
respOffset = 
increase () 


1 - No exception shall be thrown. 
Bit 7 of resp[7] shall not be set (0), 
indicating that increase is not 
allowed. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT 
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6.1.1.10.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


2,3 


PI 


4 


P2 


5 


P3 


6 


P4 


7 


P5 


8 


P6 


9 


P7 


10 


CI 


1 


C2 


11 


C3 


14 


C4 


12 


C5 


13 


C6, C7 


Not Tested 



6.1.1.11 Method invalidate 

Test Area Reference: API_1_SVW_INVL 

6.1 .1 .1 1 .1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void invalidate ( ) 

throws SIMViewException 

Normal execution 

CRRNl: The currently selected EF of the calling applet shall be invalidated, i.e. the flag in the EF file status shall be 
changed accordingly. 

Parameter errors 
No requirements. 

Context errors 

CRRCl: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the calling applet does not fulfil the access condition, INVALIDATE, to perform this function, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.AC_NOT_FULFILLED. 

CRRC3: If the currently selected EF is already invalidated, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC4: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.11.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 
Test Script: API_l_SVW_INVL_l.scr 

Test Applet: API_l_SVW_INVL_l.java 
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Load Script: 
Cleanup Script: 

6.1.1.11.3 



API_1_S VW_INVL_1 .Idr 
API_1_S VW_INVL_1 .clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF is selected 

1 - invalidate () 


1 - Shall throw 

Sim. access. SIMViewException with 

reason code NO EF SELECTED. 




2 


Invalidate EF 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFTNR 
select ( ) 

3 - invalidate ( ) 

4 - rehabilitate 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 




3 


Access condition not fulfilled 

1 - fid = EFCNIV 
select ( ) 

2 - invalidate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIIVIViewException with 

reason code 

AC NOT FULFILLED. 




4 


EF is already invalidated 

1 - fid = EFTNR 
select ( ) 

2 - invalidate ( ) 

3 - invalidate () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIIVIViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 





6.1.1.11.4 



Test Coverage 



CRR number 


Test Case Number 


N1 


2 


C1 


1 


C2 


3 


C3 


4 


C4, C5 


Not Tested 



6.1.1.12 Method rehabilitate 

Test Area Reference: API_1_SVW_REHA 

6.1.1.12.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void rehabilitate ( ) 

throws SIMViewException 

Normal execution 

CRRNl: The currently selected EF of the calling applet shall be rehabilitated, i.e. the flag in the EF file status shall 
be changed accordingly. 

Parameter errors 
No requirements. 

Context errors 

CRRC 1 : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.NO_EF_SELECTED. 
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CRRC2: If the calling applet does not fulfil the access condition, REHABILITATE, to perform this function, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.AC_NOT_FULFILLED. 

CRRC3: If the currently selected EF is not invalidated, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

CRRC4: If the method call causes a memory problem (e.g. memory access error), an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.12.2 Test Suite Files 

Additional requirements for the GSM personalisation: None 

Test Script: API_l_SVW_REHA_l.scr 

Test Applet: API_l_SVW_REHA_l.java 

Load Script: API_l_SVW_REHA_Lldr 

Cleanup Script: API_l_SVW_REHA_Lclr 



6.1.1.12.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialisation 


Responses ignored. 




1 


No EF is selected 

1 - rehabilitate 


1 - Shall throw 

Sim. access. SIIVIViewException with 

reason code NO EF SELECTED. 




2 


Rehabilitate invalidated File 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFCNR 
select ( ) 

3 - invalidate 

4 - rehabilitate 

5 - byte[] incr = new byte[3] = {0,0,1} 
incrOffset = 

byte[] resp = new byte[l] = 1 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - No exception shall be thrown. 
resp[] shall contain {0,0,1}. 




3 


Access condition not fulfilled 

1 - fid = EFCNRH 
select 

2 - rehabilitate 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

AC NOT FULFILLED.. 




4 


Rehabilitate validated File 

1 - fid = EFCNR 
select 

2 - rehabilitate 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 





6.1.1.12.4 



Test Coverage 



CRR number 


Test Case Number 


N1 


2 


C1 


1 


C2 


3 


C3 


4 


C4, C5 


Not Tested 
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6.1.2 Class SIMSystem 

6.1 .2.1 Method getTheSIMView 

Test Area Reference: API_1_SSY_GETS 

6.1.2.1.1 Conformance Requirement: 

The method with following header shall compliant to its definition in the API. 

public static SIMView getTheSIMView ( ) 

Normal execution 

CRRNl: returns a reference to class which implements the SIMView interface 

Parameters error 
No requirements 

Context errors 
No requirements 

6.1.2.1.2 Test suite files 

No additional requirements for the GSM personalisation: 
Test Script: API_l_SSY_GETS_l.scr 

Test Applet: API_l_SSY_GETS_l.java 

Load Script: API_l_SSY_GETS_l.ldr 

Cleanup Script: API_l_SSY_GETS_l.clr 
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6.1.2.1.3 



6.1.2.1.4 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


reference not equal null after execute 


The returned reference shall be not 
null after execute 




2 


reference to the GSM interface 


Returned a reference to the GSM 
interface 





Test Coverage 



CRR number 


Test case number 


N1 


1,2 



6.1 .3 Class SIMViewException 

6.1.3.1 Method throwit 

Test Area Reference: API_1_SVE_THITS 

6.1.3.1.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 
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public static void throwit (short reason) 
throws SIMViewException 

Normal execution 

CRRNl: Throws the JCRE instance of SIMViewException with the specified reason 
CRRN2: Extends javacard.framework.CardRuntimeException 

Parameter errors 
No requirements 

Context errors 
No requirements 

6.1.3.1.2 Test Suite Files 

No additional requirements for the GSM personalisation 
Test Script: API_l_SVE_THITS_l.scr 

Test Applet: API_l_SVE_THITS_l.java 

Load Script: API_l_SVE_THITS_l.ldr 

Cleanup Script: API_l_SVE_THITS_l.clr 

6.1.3.1.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Throws the JCRE instance of 
SIMViewException with the specified reason 


Reason = 




2 


Throws the JCRE instance of 
SIMViewException with the specified reason 


Reason = 1 




3 


Throws the JCRE instance of 
SIMViewException with the specified reason 


Reason = 15 




4 


SIMViewException extends 
javacard.framework.CardRuntimeException 


Reason = 




5 


SIMViewException extends 
javacard.framework.CardRuntimeException 


Reason = 1 




6 


SIMViewException extends 
javacard.framework.CardRuntlmeException 


Reason = 15 





6.1.3.1.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


4,5,6 



6.1.3.2 Constructor 

Test Area Reference: API_l_SVE_COORS 

6.1.3.2.1 Conformance Requirement: 

The method with following header shall compliant to its definition in the API. 

public SIMViewException (short reason) 
throws SIMViewException 
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Normal execution 

CRRNl: Construct a SIMViewException with the specified reason 

Parameters error 
No requirements 

Context errors 
No requirements 

6.1.3.2.2 Test suite files 

No additional requirements for the GSM personahsation 
Test Script: API_l_SVE_COORS_l.scr 

Test Applet: API_l_SVE_COORS_l.java 

Load Script: API_l_SVE_COORS.ldr 

Cleanup Script: API_l_SVE_COORS.clr 



6.1.3.2.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


SIMViewException with the specified reason 

(The reason shall set with setReason and 
compare the Exception with getReason) 


Reason (specified) 





6.1.3.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1 



6. 1.3. 3 Reason Codes 

Test Area Reference: APl_l_SVE_CONS 

6.1.3.3.1 Conformance Requirement: 

There is no API, only constants. This constants shall compliant to its definition in the API. 

Normal execution 

CRRNl: The Constants of the class SIMViewException shall all have the same name and value defined in the 
GSM03.19 

CRRN2: Constructs SIMViewException a Exception with the specified reason 

Parameters error 
No requirements 

Context errors 
No requirements 
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6.1.3.3.2 


Test suite files 


None 




6.1.3.3.3 


Test Procedure 



The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed 

6.2 Package sim.toolkit 
6.2.1 Interface ToolkitConstants 
6.2.1.1 Constants 

Test Area Reference: API_2_TKC_CONS 

6.2.1.1.1 Conformance Requirement: 

There is no API, only constants. This constants shall be compare to its definition in the API. 

Normal execution 

CRRNl: The Toolkit Constants shall all have the same name and value defined in the GSM03.19 normaUzation. 



Parameters error 




No requirements 




Context errors 




No requirements 




6.2.1.1.2 


Test suite files 


None 




6.2.1.1.3 


Test Procedure 



The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.2.2 Interface Toolkitlnterface 
6.2.2.1 Method processToolkit 

Test Area Reference: API_1_TKI_PRTKB 

6.2.2.1.1 Conformance Requirement: 

The method with following prototype shall compliant to its definition in the API. 

public void processToolkit (byte event) 
throws ToolkitException 

Normal execution 

CRRNl: This interface must be implemented by a Toolkit applet (which extends the javacard.framework. Applet 
class) so that it can be triggered by the Toolkit Handler according to the registration information. 
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CRRN2: The Toolkit applet will have to implement the processToolkit shared method so that the following events 
can be notified: 



Event 


Description 


EVENT_PROFILE_DOWNLOAD 


Terminal Profile command reception 


EVENT_FORMATTED_SMS_PP_ENV 


03.48 formatted envelope SMS-PP Data 
Download reception 


EVENT_FORMATTED_SMS_PP_UPD 


03.48 formatted Update Record EF SMS 


EVENT_UNFORMATTED„SMS„PP„ENV 


Unformatted Envelope SIVIS-PP Data Download 
reception 


EVENT_UNFORMATTED_SMS_PP_UPD 


Unformatted Update Record EF SMS 


EVENT_UNFORMATTED_SMS_CB 


Unformatted Cell Broadcast Data Download 
command reception 


EVENT_MENU_SELECTION 


Envelope Menu Selection command reception 


EVENT_MENU_SELECTION_HELP_REQUEST 


Envelope Menu Selection Help Request 
command reception 


EVENT_CALL_CONTROL_B Y_S IM 


Envelope Call Control by SIM command 
reception 


EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 


Envelope MO Short Message Control by SIM 
command reception 


EVENT_TIMER_EXPIRATION 


Envelope Timer Expiration 


EVENT_EVENT_DOWNLOAD_MT_CALL 


Envelope Event Download - MT call 


EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 


Envelope Event Download - Call connected 


EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 


Event Download - Call disconnected 


EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 


Envelope Event Download - Location status 


EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 


Envelope Event Download - User activity 


EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 


Envelope Event Download - Idle screen available 


EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 


Envelope Event Download - Card Reader Status 


EVENT_STATUS_COI«AND 


Status APDU command event 


EVENT_UNRECOGNIZED_ENVELOPE 


Unrecognized Envelope command reception 



Parameters error 
No requirements 

Context errors 
No requirements 

6.2.2.1.2 



Test suite files 



The method is tested in the Framework 



6.2.2.1.3 



Test Coverage 



CRR number 


Test case number 


N1 


Tested in Framework 


N2 


Tested in Framework 



6.2.3 Class EditHandler 

It is not possible to test the methods provided by this class as it is declared 'abstract'; it will be done in the class 
inheriting it: EnvelopeResponseHandler, ProactiveHandler. 

6.2.4 Class EnvelopeHandler 
6.2.4.1 Method getEnvelopeTag 

Test Area Reference: API 2 ENH GENT 
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6.2.4.1.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte getEnvelopeTag ( ) 

Normal execution 

CRRNl: The method shall return the Envelope BER-TLV tag. 

CRRN2: The Envelope BER TAG is available for all triggered toolkit applets from the invocation to the termination 
of their processTooUcit method if the EnvelopeHandler is available. 

Parameters error 

Context errors 

6.2.4.1.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.1.3 



Test suite files 

API_2_ENH_GENT_1 .scr 
API_2_ENH_GENT_1 .Java 
API_2_ENH_GENT_1 .Idr 
API_2_ENH_GENT_1 .clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getEnvelopeTag called just after triggering of the 
application. 


Returns OxD1 




2 


getEnvelopeTag called after a proactive 
command. 


Returns OxD1 




3 


getEnvelopeTag called after a second proactive 
command. 


Returns OxD1 





6.2.4.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


1,2,3 



6.2.4.2 Method getltemldentifier 

Test Area Reference: API_2_ENH_GIID 

6.2.4.2.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte getltemldentif ier ( ) 

throws ToolkitException 

Normal execution 

CRRNl :The method shall return the item identifier byte value. 

CRRN2:The item identifier byte value returned shall be from the first Item Identifier TLV element. 

CRRN3: If the element is available it becomes the TLV selected. 
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CRRN4: The item identifier is available for all triggered toolkit applets from the invocation to the termination of 
their processToolkit method if the EnvelopeHandler is available. 

Parameters error 
No requirements. 

Context errors 

CRRCl: The method shall throw ToolkitException (UNAVAILABLE_ELEMENT) if the item identifier TLV is not 
present. 

CRRC2: The method shall throw ToolkitException (OUT_OF_TLV_BOUND ARIES) if the item identifier byte is 
missing in the Item Identifier Simple TLV. 



6.2.4.2.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.2.3 



Test suite files 

API_2_ENH_GIID_1 .scr 
API_2_ENH_GIID_1 .j ava 
API_2_ENH_GIID_1 .Idr 
API_2_ENH_GIID_1 .clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send envelope SMS-PP Formatted with item 
identifier TLV and identifier value of 03 


Returns 03 




2 


Send envelope SMS-PP Formatted with two item 
identifier TLV with first value FF and second 44 


Returns FF 




3 


Send envelope SMS-PP Formatted with two item 
identifier TLV with first value 81 and second 44, 
call twice the method getltemldentifier 


Returns 81 
Returns 81 




4 


Send envelope SMS-PP Formatted with item 
identifier TLV and value of 66. FindTLV with TAG 
02. getltemldentifier and then getValueByte with 
offset 


getltemldentifier=getValueByte 




5 


Send envelope SMS-PP Formatted without item 
identifier TLV and getltemldentifier 


ToolkitException 
(UNAVAILABLE ELEMENT) 




6 


Send Envelope SMS-PP Formatted with item 
identifier TLV (66), send proactive command. Then 
getltemldentifier 


Returns 66 




7 


Send Envelope SMS-PP Formatted with item 
identifier TLV but without item number 


ToolkitException 
(OUT_OF_TLV_BOUNDARIES) 





6.2.4.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


2,3 


N3 


4 


N4 


6 


CI 


5 


C2 


7 



6.2.4.3 Method getSecuredDataLength 

Test Area Reference: API 2 ENH GSDL 
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6.2.4.3.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getSecuredDataLength ( ) 

throws ToolkitException 

Normal execution 

CRRNl: The method shall return the length of the secured data contained in a SMS TPDU TLV. 

CRRN2: The length is fi-om the first SMS TPDU TLV. 

CRRN3: The length should not include padding bytes. 

CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_ENV and if the SMS TP-UD is 
formatted according to GSM03.48. 

CRRN5: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD and if the SMS TP-UD is 
formatted according to GSM03.48. 

CRRN6: If the method is successful, the selected TLV should be the SMS TPDU TLV. 

Parameters error 
No requirements 

Context errors 

CRRCl: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of unavailable SMS 
TPDU TLV element. 

CRRC2: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of missing Secured 
Data. 

6.2.4.3.2 Test suite files 
Specific triggering: 

- SMS CB 

- FORMATTED SMS PP UPD 

- UNFORMATED SMS PP ENV 

For Formatted triggering if CC/RC/DS is used, the security parameters are the one used for downloading 
applications. 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.3.3 



API_2_ENH_GSDL_1 .scr 
API_2_ENH_GSDL_1 .Java 
API_2_ENH_GSDL_1 .Idr 
API_2_ENH_GSLD_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Test with TP-OA length of 2 


Returns 0x2A 




2 


Test with TP-OA length of 6 


Returns 0x2A 




3 


Test with TP-OA length of 12 


Returns 0x2A 




4 


Test with RC/CC/DS length of 


Returns 0x10 




5 


Test with RC/CC/DS length of 8 


Returns 0x10 




6 


Test with PCNTR = 


Returns 0x10 
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7 


Test with PCNTR = 7 


Returns 0x05 




8 


Test with SecuredDataLength = 00 


Returns 0x00 




9 


Test with UserDataLength = 0x33 


Returns 0x33 




10 


Test with UserDataLength = Ox 6C 


Returns Ox 6C 




11 


Test with UserDataLength = Ox 6D 


Returns Ox 6D 




12 


Test with UserDataLength = maximum length: 
0x79 


Returns Ox 79 




13 


Verify it is the first TPDU TLV: 

Send a SIVIS PP with 2 TPDU TLV and inside two 

different secured data lengths: 5 and 10 


Returns 0x05 




14 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns 0x2A 




15 


Same test as 2 but with 
FORMATTED SMS PP UPD 


Returns 0x2A 




16 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x2A 




17 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x10 




18 


Same test as 5 but with 
FORMATTED SMS PP UPD 


Returns 0x10 




19 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x10 




20 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x05 




21 


Same test as 5 but with 
FORMATTED SMS PP UPD 


Returns 0x00 




22 


Same test as 6 but with 
FORMATTED SMS PP UPD 


Returns 0x33 




23 


Same test as 7 but with 
FORMATTED SMS PP UPD 


Returns Ox 6C 




24 


Same test as 8 but with 
FORMATTED SMS PP UPD 


Returns Ox 6D 




25 


Same test as 9 but with 
FORMATTED SMS PP UPD 


Returns Ox 79 




26 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns 0x05 




27 


Verify after call of the method the current TLV is 
the TPDU TLV: 

findTLV device identities, getSecuredDataLength 
and then getValueByte to verify that the current 
TLV is the TPDU TLV 


getValueByte returns 0x40 




28 


Send an envelope SMS CB, 
getSecuredDataLength 


ToolkitException 
UNAVAILABLE ELEMENT 




29 


Send an envelope SMS PP unformatted 


ToolkitException 
UNAVAILABLE ELEMENT 





6.2.4.3.4 Test Coverage 

This method has only been tested with call control and the tests shall be improved during 03.48 tests. 



CRR number 


Test case number 


N1 


1,2,3,4,5,6,7,8,9, 10, 
11, 12, 13 


N2 


13 


N3 


6,7 


N4 


1,2,3,4,5,6,7,8,9,10, 
11, 12, 13,25 


N5 


14, 15, 16, 17, 18, 19,20, 
21,22,23,24,25,26 


N6 


27 


C1 


28 


C2 


29 
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6.2.4.4 Method getSecuredDataOffset 

Test Area Reference: API_2_ENH_GSDO 

6.2.4.4.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getSecuredDataOf f set ( ) 

throws ToolkitException 

Normal execution 

CRRNl: The method shall return the offset of the secured data first byte contained in a SMS TPDU TLV. 

CRRN2: The offset is from the first SMS TPDU TLV. 

CRRN3: The method can be used if the event is EVENT_FORMATTED_SMS_PP_ENV and if the SMS TP-UD is 
formatted according to GSM03.48. 

CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD and if the SMS TP-UD is 
formatted according to GSM03.48. 

CRRN5: If the method is successful, the selected TLV should be the SMS TPDU TLV. 

Parameters error 
No requirements 

Context errors 

CRRCl: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of unavailable SMS 
TPDU TLV element. 

CRRC2: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of missing Secured 
Data. 

6.2.4.4.2 Test suite files 
Specific triggering: 

SMS CB 

FORMATTED SMS PP UPD 
UNFORMATED SMS PP ENV 

For Formatted triggering if CC/RC/DS is used, the security parameters are the one used for 
downloading applications. 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.4.3 



API_2_ENH_GSDO_l .scr 
API_2_ENH_GSDO_l .Java 
API_2_ENH_GSDO_l .Idr 
API_2_ENH_GSDO_l .clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Test with TP-OA length of 2 


Returns 0x21 




2 


Test with TP-OA length of 6 


Returns 0x23 




3 


Test with TP-OA length of 12 


Returns 0x26 




4 


Test with RC/CC/DS length of 


Returns 0x21 




5 


Test with RC/CC/DS length of 8 


Returns 0x29 




6 


Send a SMS PP with 2 TPDU TLV and inside two 
different secured data offsets 


Returns 0x24 ( the first offset ) 
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7 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns 0x21 




8 


Same test as 2 but with 
FORMATTED SMS PP UPD 


Returns 0x23 




9 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x26 




10 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x21 




11 


Same test as 5 but with 
FORMATTED SMS PP UPD 


Returns 0x29 




12 


Same test as 6 but with 
FORMATTED SMS PP UPD 


Returns 0x24 ( the first offset ) 




13 


Verify after call of the method the current TLV is 
the TPDU TLV: 

findTLV device identities, getSecuredDataOffset 
and then getValueByte to verify that the current 
TLV is the TPDU TLV 


Returns 0x40 




14 


Send an envelope SMS CB, 
getSecuredDataOffset 


ToolkltException 
UNAVAILABLE ELEMENT 












15 


Send an envelope SMS PP unformatted 


ToolkltException 
UNAVAILABLE ELEMENT 




16 


Send an envelope SMS-PP formatted with no 
secured data , getSecuredDataOffset 


Returns 0x21 





6.2.4.4.4 Test Coverage 

This method has only been tested with call control and the tests shall be improved during 03.48 tests. 



CRR number 


Test case number 


N1 


1,2,3,4,5,6,16 


N2 


6, 12 


N3 


1,2,3,4,5,6, 16 


N4 


7,8,9, 10, 11 


N5 


13 


C1 


14 


C2 


15 



6.2.4.5 Method getTheHandler 

Test Area Reference: API_2_ENH_GTHD 

6.2.4.5.1 Conformance Requirements 

The method with following header shall be compliant to its definition in the API. 

public static EnvelopeHandler getTheHandler ( ) 

throws ToolkltException 

Normal execution 

CRRNl: The method shall return the single system instance of the EnvelopeHandler class. 

CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object ( see Javacard 2.1 Runtime Environment 
(JCRE) Specification [12]) 

Parameters error 
No requirements 
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Context errors 

CRRCl: The method shall thrown ToolkitException (HANDLER_NOT_AV AIL ABLE) if the handler is busy. 

6.2.4.5.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.5.3 Test Procedure 



Test suite files 

API_2_ENH_GTHD_1 .scr 
API_2_ENH_GTHD_1 .Java 
API_2_ENH_GTHD_1 .Idr 
API_2_ENH_GTHD_1 .clr 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler twice 


The returned objects shall be the 
same 




2 


Verify that getTlieHandler returns an 

EnvelopeHandler 

GetTheHandler 


The reference returned shall be an 
EnvelopeHandler (checkcast) 




3 


Verify the returned value is not null 
GetTheHandler 


The reference returned shall not be 
null. 





6.2.4.5.4 



Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


To be checked in 

Framework tests and 

insert here cross 

reference 


C1 


To be checked in 

Framework tests and 

insert here cross 

reference 



6.2.4.6 Method getTPUDLOffset 

Test Area Reference: API_2_ENH_GTPO 

6.2.4.6.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getTPUDLOf f set ( ) 

throws ToolkitException 

Normal execution 

CRRNl: The method shall return the TPUDL offset in a SMS TPDU TLV. 

CRRN2: The offset is from the first SMS TPDU TLV. 

CRRN3: The method can be used if the event is EVENT_FORMATTED_SMS_PP_ENV. 

CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD. 

CRRN5: The method can be used if the event is EVENT_UNFORMATTED_SMS_PP_ENV. 

CRRN6: The method can be used if the event is EVENT_UNFORMATTED_SMS_PP_UPD. 
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CRRN7: If the method is successful, the selected TLV should be the SMS TPDU TLV. 

Parameters error 
No requirements 

Context errors 

CRRCl: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of unavailable SMS 
TPDU TLV element. 

CRRC2: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) if the TPUDL field does not 

exist. 



6.2.4.6.2 
Specific triggering: 



Test suite files 



FORMATTED SMS PP UPD 
UNFORMATTED SMS PP UPD 
UNFORMATTED SMS PP ENV 
SMS CB 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.6.3 



API_2_ENH_GTP0_1 .scr 
API_2_ENH_GTPO_l .Java 
API_2_ENH_GTPO_l .Idr 
API_2_ENH_GTPO_l .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Test with TP-OA length of 2 


Returns 0x0 D 




2 


Test with TP-OA length of 6 


Returns OxOF 




3 


Test with TP-OA length of 12 


Returns 0x12 




4 


Send a SMS PP with 2 TPDU TLV and inside two 
different DDL offsets 


Returns 0x10 ( the first offset ) 




5 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns OxOD 




6 


Same test as 2 but with 
FORMATTED SMS PP UPD 


Returns OxOF 




7 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x12 




8 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x10 ( the first offset ) 




9 


Same test as 1 but with 
UNFORMAI IbD SMS PP UPD 


Returns OxOD 




10 


Same test as 2 but with 
UNFORMAI IbD SMS PP UPD 


Returns OxOF 




11 


Same test as 3 but with 
UNFORMAI IbD SMS PP UPD 


Returns 0x12 




12 


Same test as 4 but with 
UNFORMAI IbD SMS PP UPD 


Returns 0x12 ( the first offset ) 




13 


Same test as 1 but with 
UNFORMAI IbD SMS PP ENV 


Returns OxOD 




14 


Same test as 2 but with 
UNFORMAI IbD SMS PP ENV 


Returns OxOF 




15 


Same test as 3 but with 
UNFORMAI IbD SMS PP ENV 


Returns 0x12 




16 


Same test as 4 but with 
UNFORMAI IbD SMS PP ENV 


Returns 0x10 ( the first offset ) 




17 


Verify after call of the method the current TLV is the 

TPDU TLV: 

findTLV device identities, getTPUDLOffset and then 


Returns 0x40 
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getValueByte to verify that the current TLV is the 
TPDU TLV 






18 


Send an envelope SIVIS CB, getTPUDLOffset 


Tooll<itException 
UNAVAILABLE ELEMENT 





6.2.4.6.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,6,7,8,9,10, 
11, 12, 13, 14, 15, 16, 17 


N2 


4 


N3 


1,2,3,4, 17 


N4 


5, 6, 7, 8 


N5 


13, 14, 15, 16 


N6 


9, 10, 11, 12 


N7 


17 


C1 


18 


C2 


Don't no how to test 



6.2.4.7 Method getLength 

Test Area Reference: API_2_ENH_GLEN 

6.2.4.7.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

Normal execution 

CRRNl : returns the length in bytes of the TLV list. 

Parameter Error 
No requirements 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

6.2.4.7.2 Test Suite files 
Specific triggering: None 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



API_2_ENH_GLEN_1 .scr 
API_2_ENH_GLEN_1 .Java 
API_2_ENH_GLEN_1 .Idr 
API_2_ENH_GLEN_1 .ck 
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6.2.4.7.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send an envelope SMS PP with BER length of 
0x31 


Result of getLengthO is 0x0031 




2 


Send an envelope SMS PP with BER length of 
0x7F 


Result of getLengthO is 0x007Fh 




3 


Send an envelope SMS PP with BER length of 
81 80 


Result of getLengthO is 0x0080h 




4 


Send an envelope SMS PP with BER length of 
81 FC 


Result of getLengthO is OxOOFCh 





6.2.4.7.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


CI 


Does not apply for 
EnvelopeHandler 



6.2.4.8 Method copy 

Test Area Reference: API 2 ENH COPY BSS 



6.2.4.8.1 



Conformance Requirement 



The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

CRRN 1 : copies the simple TL V list contained in the handler to the destination byte array. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null a NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, an 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.4.8.2 Test Suite files 

Specific triggering: None 

Test Script: API_2_ENH_COPY_BSS_l.scr 

Test Applet: API_2_ENH_COPY_BSS_l.java 
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Load Script: 
Cleanup Script: 

6.2.4.8.3 



API_2_ENH_COPY_BSS_l .Idr 
API_2_ENH_ COPY _ BSS _l.clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

dstBuffer . length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsException is 
thrown 




5 


DstOffset + dstLength > dstBuffer.length 

DstBuffer.length = 5 
DstOffset = 3 
DstLength = 3 


ArraylndexOutOfBoundsException is 
thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsException is 
thrown 




7 


DstLength > length of the simple TLV list 

DstBuffer.length = 48 
DstOffset = 
DstLength = 48 


ToolkitException.OUT OF TLV BO 
UNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

DstBuffer.length = 47 
DstOffset = 
DstLength = 47 


Result of copyO is 0X0047 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

DstBuffer.length = 50 
dstOffset = 3 
dstLength = 47 


Result of copyO is 0X0032 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 0X0009 




13 


Compare the whole buffer 


Result of arrayCompareO is 




14 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 260 
dstOffset = 257 
dstLength = 3 


Result of copyO is 0X0104 




15 


Compare the whole buffer 


Result of arrayCompareO is 




16 


Successful call, copy with length =0 

dstBuffer.length = 260 
dstOffset = 260 
dstLength = 


Result of copyO is 0x1 04 





6.2.4.8.4 



Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13, 15 


N2 


8, 10, 12, 14, 16 


PI 


1 


P2 


2,3,4,5,6 


P3 


7 


CI 


Does not apply for 
EnvelopeHandler 
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6.2.4.9 Method findTLV 

Test Area Reference: API_2_ENH_FINDBB 

6.2.4.9.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag is 

set. 

CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension Required 
flag is not set. 

CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

CRRN5: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.4.9.2 Test Suite files 
Specific triggering: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.9.3 



API_2_ENH_ENH_FINDBB_Lscr 
API_2_ENH_ENH_FINDBB_1 .Java 
API_2_ENH_ENH_FINDBB_1 .Idr 
API_2_ENH_FINDBB_1 .clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Trig the applet with SMS PP including one more 
tag 02 and one TAG 04 






1 


Invalid input parameter 

Occurrence = 


ToolkitException. BAD INPUT P 
ARAMETER is thrown 




2 


SearchlstTLV 

Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 0x02 




4 


Search 2nd TLV 

Tag = 06h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 
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5 


Call the getValueLengthO method 


Result is 0x05h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

Tag = 03h 
Occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




8 


Search a tag with wrong occurrence 

Tag = 02h 
Occurrence = 3 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




10 


Search the TLV 

Tag = 02h 
Occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Search the TLV 

Tag = 04h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

Tag = 86h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 





6.2.4.9.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2,4 


N3 


10, 11 


N4 


6,7,8,9 


N5 


12, 13 


PI 


1 


CI 


Does not apply for 
EnvelopeHandler 



6.2.4.10 Method getValueLength 

Test Area Reference: API_2_ENH_GVLE 

6.2.4.10.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 

Normal execution 

CRRNl: gets and returns the binary length of the value field for the last TLV element which has been found in the 
handler. 

Parameter errors 
No requirements 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 
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Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.10.3 



API_2_ENH_GVLE_1 .scr 
API_2_ENH_GVLE_1 .Java 
API_2_ENH_GVLE_1 .Idr 
API_2_ENH_GVLE_1 .clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 33, Length C8 






1 


getValueLengthO 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 02h 








getValueLength ( ) 


Result is 0X0002 




3 


Search TLV OBh 








getValueLength ( ) 


Result is 0X0024 




4 


Search TLV 33h 








getValueLength ( ) 


Result is 0X00C8 





6.2.4.10.4 



Test Coverage 



CRR number 


Test case number 


N1 


2, 3,4 


CI 


Does not apply for 
EnvelopeHandler 


C2 


1 



6.2.4.1 1 Method getValueByte 

Test Area Reference: API_2_ENH_GVBYS 

6.2.4.11.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 

Normal execution 

CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 byte). 

Parameter errors 

CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



£75/ 



3GPP TS 11.13 version 7.2.0 Release 1998 

6.2.4.11.2 Test Suite files 

Specific triggering: None 



73 



ETSI TS 101 955 V7.2.0 (2001-09) 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.11.3 



API_2_ENH_GVBY.scr 
API_2_ENH_GVB Y_l .Java 
API_2_ENH_GVBY.ldr 
API_2_ENH_GVB Y_l .clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 33, Length C8 
Valued 02... 






1 


getValueByte(O) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 02h 








getValueByte{2) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 02h 








getValueByte(l) 


Result is 0x81 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte(O) 


Result is 83h (Source) 




5 


Search TLV 33h 








getValueByte (7E) 


Result is 0x7F 




6 


Search TLV 33h 








getValueByte (80) 


Result is 0x81 




7 


getValueByte (7F) 


Result is 0x80 




8 


Search TLV B3h 








getValueByte (C7) 


Result is 0xG8 





6.2.4.11.4 



Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for 
EnvelopeHandler 


C2 


1 



6.2.4.12 Method copyValue 

Test Area Reference: API_2_ENH_CPYVS_BSS 

6.2.4.12.1 Conformance Requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue (short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException^ 
Toolkit Except ion 

Normal execution 

CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 
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CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.4.12.3 Test Suite files 

Specific triggering: None 

Test Script: 

Test Applet: 

Load Script: 

Cleanup Script: 



API_2_ENH_CPYVS_BSS_1 .scr 
API_2_ENH_CPYVS_BSS_1 .Java 
API_2_ENH_CPYVS_BSS_1 .Idr 
API 2 ENH CPYVS BSS l.ck 



6.2.4.12.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Search TLV 02h 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


Search TLV OBh 








dstOffset > dstBuffer.length 

dstBuffer .length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n Is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Search TLV 06h 








valueOffset > TLV Length 

valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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dstLength = 1 






9 


dstLength > TLV length 

valueOffset = 
dstBuffer .length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > TLV length 

valueOffset = 2 
dstBuffer .length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Search TLV 01 h 








copyValue () 


ToolkitException.UNAVAILABLE 
_ELEMENT is thrown on the 
copyValueO method 




12 


Search TLV 06h 








Successful call 

valueOffset = 
dstBuffer .length = 6 
dstOffset = 
dstLength = 6 


Result of copyValueO is 0x0006 




13 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

valueOffset = 1 
dstBuffer. length = 20 
dstOffset = 3 
dstLength = 4 


Result of copyValueO is 0x0007 




15 


Compare buffer 

buffer = 
55 55 55 11 22 
33 44 55 55 55 
55 55 55 55 55 
55 55 55 55 55 


Result is OOh 




16 


Successful call, copy with length =0 

dstBuffer. length = 20 
dstOffset = 20 
dstLength = 


Result of copyValueQ is 20 





6.2.4.12.4 



Test Coverage 



CRR number 


Test case number 


N1 


13,15 


N2 


12, 14, 16 


PI 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


CI 


Does not apply for 
EnvelopeHandler 


C2 


11 



6.2.4.13 Method compareValue 

Test Area Reference: API_2_ENH_CPRVS_BSS 



6.2.4.13.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte[] compareBuf fer, 
short compareOf f set , 
short compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 
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Normal execution 

Compares the last found TLV element with a buffer: 

CRRNl: returns if identical. 

CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 

CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.4.13.3 Test Suite files 

Specific triggering: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.13.3 



API_2_ENH_CPRVS_BSS_Lscr 
API_2_ENH_CPRVS_BSS_1 .Java 
API_2_ENH_CPRVS_BSS_1 .Idr 
API_2_ENH_CPRVS_BSS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Search TLV 02h 








compareValue with a null compareBuffer 


NullPointerException is thrown 




2 


Search TLV OBh 








compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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compareOf f set = 
compareLength = -1 






7 


Search TLV 06h 








valueOffset > TLV Length 

valueOffset = 6 
compareBuff er . length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuff er . length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > TLV length 

valueOffset = 
compareBuff er . length = 15 
compareOf f set = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > TLV length 

valueOffset = 2 
compareBuffer . length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Search TLV 01 h 


Result is TLV NOT FOUND 






compareValue () 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 




12 


Search TLV 06h 








Initialise compareBuffer 

compareBuffer = 
81 11 22 33 44 F5 








Compare buffers 

valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




13 


Initialise compareBuffer 

compareBuffer = 
7F 11 22 33 44 F5 








Compare buffers with same parameters 


Result is -1 




14 


Initialise compareBuffer 

compareBuffer = 
83 11 22 33 44 F5 








Compare buffers with same parameters 


Result is -1 




15 


Initialise compareBuffer 

compareBuffer = 

55 55 55 81 11 22 33 44 F5 

55 55 55 55 55 








Compare buffers 

valueOffset = 1 
compareOf f set = 4 
compareLength = 5 


Result is OOh 




16 


Initialise compareBuffer 

compareBuffer = 

55 55 55 81 10 22 33 44 F5 

55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




17 


Initialise compareBuffer 

compareBuffer = 

55 55 55 81 12 22 33 44 F5 

55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




18 


Successful call, compareValue with length =o 

CompareBuffer . length = 15 
CompareOf f set = 15 
CompareLength = 


Result of compareValueO is 
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6.2.4.13.4 



Test Coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13, 16, 18 


N3 


14, 17 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Does not apply for 
EnvelopeHandler 


C2 


11 



6.2.4.14 Method findAndCopyValue(byte tag, byte[] dstBuffer, short dstOffset) 

Test Area Reference: API 2 ENH FACYB BS 



6.2.4.14.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[l dstBuffer, 

short dstOffset) 
throws Java . lang . NullPointerException, 
Java .lang . ArraylndexOutOfBoundsException, 

ToolkitException 



Normal execution 

CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into a 
destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.4.14.3 Test Suite files 

Specific triggering: None 

Test Script: 

Test Applet: 

Load Script: 

Cleanup Script: 



API_2_ENH_FAC YB_BS_1 .scr 
API_2_ENH_FAC YB_BS_1 .Java 
API_2_ENH_FAC YB_BS_1 .Idr 
API_2_ENH_FAC YB_BS_1 .clr 
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6.2.4.14.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


FindAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

tag = 06h 

dstBuffer.length = 06 
dstOffset = 06 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

dstBuffer.length = 06 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


length > dstBuffer.length 

dstBuffer.length = 05 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


DstOffset + length >dstBuffer.length 

DstBuffer.length = 06 
DstOffset = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 03h 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Successful call 

Tag = 06h 

DstBuffer.length = 06 
DstOffset = 


Result of findAndCopyValue () is 
0006 




8 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




9 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

dstBuffer.length = 12 
dstOffset = 2 


Result of findAndCopyValue () is 
0008 




10 


Compare buffer 

buffer = 

55 55 81 11 22 33 44 F5 55 55 55 55 


Result is OOh 




11 


Successful call 

tag = 02h 

dstBuffer.length = 2 
dstOffset = 


Result of findAndCopyValue () is 
0002 




12 


Compare buffer 

buffer = 83 81 


Result is OOh 




13 


Successful call (with tag 82h) 

tag = 82h 

dstBuffer.length = 02 
dstOffset = 


Result of findAndCopyValue () is 
0002 




14 


Compare buffer 

buffer = 83 81 


Result is OOh 




15 


Successful call (with tag B3h) 

tag = B3h 

dstBuffer.length = C4 
dstOffset = 


Result of findAndCopyValue () is 
00C4 




16 


Compare buffer 

buffer = 01 02 ... C4 


Result is OOh 
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6.2.4.14.4 



Test Coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 
EnvelopeHandler 



6.2.4.15 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 



Test Area Reference: API_2_ENH_FACYBS_BSS 



6.2.4.15.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AV AIL ABLE. 

6.2.4.15.3 Test Suite files 

Test Script: API_2_ENH_FACYBS_BSS_l.scr 

Test Applet: API_2_ENH_FACYBS_BSS_l.java 
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Load Script: 
Cleanup Script: 

6.2.4.15.3 



API_2_ENH_FACYBS_BSS_1 .Idr 
API_2_ENH_FAC YBS_BSS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

tag = 06h, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Value Length 

tag = 06h, occurrence = 1 
valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Value length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 06h 
occurrence = 2 


ToolkitException.UNAVAILABLE 
_ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




12 


Successful call 

tag = 06h, occurrence = 1 
valueOffset = 
dstBuffer.length = 06 
dstOffset = 
dstLength = 06 


Result of findAndCopyValueO is 
6 




13 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

tag = 06h, occurrence = 1 

valueOffset = 2 


Result of findAndCopyValue () is 
0007 
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dstBuffer. length = 12 
dstOffset = 3 
dstLength = 04 






15 


Compare buffer 

buffer = 

55 55 55 22 33 44 F5 55 55 55 55 55 


Result is OOh 




16 


Successful call 

tag = 02h, occurrence = 1 
valueOffset = 
dstBuffer .length = 12 
dstOffset = 
dstLength = 2 


Result of fincJAndCopyValueO is 
0002 




17 


Compare buffer 

buffer = 83 81 55 ... 55 


Result is OOli 




18 


Successful call 

tag = 02h, occurrence = 2 
valueOffset = 
dstBuffer. length = 12 
dstOffset = 
dstLength = 2 


Result of findAndCopyValueO is 
0002 




19 


Compare buffer 

buffer = 22 44 55 ... 55 


Result is OOh 




20 


Successful call (with tag 82h) 

tag = 82h 
occurrence = 1 
valueOffset = 
dstBuffer .length = 12 
dstOffset = 
dstLength = 02 


Result of findAndCopyValue () is 
0002 




21 


Compare buffer 

buffer = 83 81 55 ... 55 


Result is OOh 




22 


Successful call (with tag 82h) 

tag = 82h 
occurrence = 2 
valueOffset = 
dstBuffer. length = 12 
dstOffset = 
dstLength = 02 


Result of findAndCopyValue () is 
0002 




23 


Compare buffer 

Buffer = 22 44 55 ... 55 


Result is OOh 




24 


Successful call, findAndCopyValue with 
length =0 

DstBuffer. length = 12 
dstOffset = 12 
dstLength = 


Result of findAndCopyValue () is 
12 





6.2.4.15.4 



Test Coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18,24 


N4 


20,21, 22,23 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


CI 


Does not apply for 
EnvelopeHandler 



6.2.4.16 Method findAndCompareValue(byte tag, byteQ compareBuffer, short 
compareOffset) 

Test Area Reference: API_2_ENH_FACRB_BS 

6.2.4.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 
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public byte f indAndCompareValue (byte tag, 

byte[] compareBuf f er, 
short compareOf f set ) 
throws Java . lang. NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 

Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 

CRRN3: if identical returns 0. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -L 

CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1. 

CRRN6; The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 



6.2.4.16.3 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.4.16.3 



Test Suite files 

API_2_ENH_FACRB_BS_1 .scr 
API_2_ENH_FACRB_BS_1 .Java 
API_2_ENH_FACRB_BS_1 .Idr 
API_2_ENH_FACRB_BS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = 06h 

compareBuffer.length = 12 
compareOffset = 12 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 12 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

compareBuffer.length = 05 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 
compareBuffer.length 

compareBuffer.length = 12 
compareOffset = 7 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Select a TLV (tag 02h) 
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findAndCompareValueQ 

tag = 03h 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F5 








Compare buffers 

tag = 06h 
compareOf f set = 


Result is OOh 




8 


Verify current TLV 

getValueLength { ) 


Result is 06 




9 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F4 








Compare buffers with same parameters 


Result is +1 




10 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F6 








Compare buffers with same parameters 


Result is -1 




11 


Initialise compareBuffer 

compareBuffer = 

55 55 81 11 22 33 44 F5 55 55 55 55 








Compare buffers 

compareOf f set = 2 


Result is OOh 




12 


Initialise compareBuffer 

compareBuffer = 

55 55 83 81 55 55 55 55 55 55 55 55 








Compare buffers 

compareOf f set = 2 


Result is OOh 




13 


Initialise compareBuffer 

compareBuffer = 

55 55 83 80 55 55 55 55 55 55 55 55 








Compare buffers 

compareOf f set = 2 


Result is +1 




14 


Initialise compareBuffer 

compareBuffer = 

55 55 83 82 55 55 55 55 55 55 55 55 








Compare buffers 

compareOf f set = 2 


Result is -1 




15 


Initialise compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








Successful call (with tag 02h) 

tag = 02h 

compareBuffer . length = 12 

compareOf f set = 


Result is OOh 




16 


Initialise compareBuffer 

CompareBuffer = 01 02 ... C4 








Successful call (with tag B3h) 

Tag = B3h 

CompareBuffer . length = C4 

CompareOf f set = 


Result is OOh 





6.2.4.16.4 



Test Coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12 


N4 


9,13 


N5 


10, 14 


N6 


15,16 


PI 


1 


P2 


2, 3, 4, 5 


CI 


Does not apply for 
EnvelopeHandler 
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6.2.4.17 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byteQ compareBuffer, short compareOffset, short compareLength) 

Test Area Reference: API_2_ENH_FACRBBS_BSS 

6.2.4.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] compareBuffer, 
short compareOffset, 
short compareLength) 
throws Java . lang. NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 

CRRN3: if identical is returned. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 

CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 

CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

CRRP4: if an input parameter is not valid (e.g. occurence = 0) an instance of ToolkitException shall be thrown. The 
reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.4.17.3 Test Suite files 

Test Script: API_2_ENH_FACRBBS_BSS_Lscr 

Test Applet: API_2_ENH_FACRBBS_BSS_Ljava 

Load Script: API_2_ENH_FACRBBS_BSS_Lldr 

Cleanup Script: API_2_ENH_FACRBBS_BSS_Lclr 
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6.2.4.17.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = 06h, occurrence = 1 
valueOffset = 
compareBuffer.length = 6 
compareOffset = 6 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareBuffer.length = 6 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Value Length 

tag = 06h, occurrence = 1 
valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Value length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Value length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


ToolkitException.BAD INPUT P 
ARAIVIETER is thrown 




12 


Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 06h 
occurrence = 2 


ToolkitException.UNAVAILABLE 
_ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




13 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F5 








findAndCompareValueO 

tag = 06h, occurrence = 1 
valueOffset = 
compareOffset = 
compareLength = 6 


Result is OOh 




14 


Verify current TLV 

getValueLength ( ) 


Result is 0006 




15 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F4 








Compare buffers with same parameters 


Result is +1 




16 


Initialise compareBuffer 

compareBuffer = 81 11 22 33 44 F6 
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Compare buffers with same parameters 


Result is -1 




17 


Initialise compareBuffer 

compareBuff er = 

55 55 55 22 33 44 F5 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 
compareLength = 4 


Result is OOh 




18 


Initialise compareBuffer 

compareBuffer = 

55 55 55 22 33 45 F5 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




19 


Initialise compareBuffer 

compareBuffer = 

55 55 55 22 33 43 F5 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


Initialise compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








findAndCompareValueO 

tag = 02h, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 2 


Result is OOh 




21 


Initialise compareBuffer 

compareBuffer = 

22 44 55 55 55 55 55 55 55 55 55 55 








findAndCompareValueO 

tag = 02h, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 2 


Result is OOh 




22 


Initialise compareBuffer 

compareBuffer = 

22 45 55 55 55 55 55 55 55 55 55 55 








findAndCompareValueO 

tag = 02h, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 2 


Result is -1 




23 


Initialise compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








Successful call (with tag 02h) 

tag = 02h, occurrence = 1 
valueOffset = 
compareBuff er . length = 12 
compareOf f set = 
compareLength = 2 


Result is OOh 




24 


Initialise compareBuffer 

compareBuffer = 01 02 ... C4 








Successful call (with tag B3h) 

tag = B3h, occurrence = 1 
valueOffset = 
compareBuffer . length = 00C4 
compareOf f set = 
compareLength = 00C4 


Result is OOh 




25 


Successful call, findAndCompareValue with 
length =0 

DstBuffer. length = C4 
DstOffset = C4 
DstLength = 


Result of findAndCompareValueO 
is OOh 





£75/ 



3GPP TS 11.13 version 7.2.0 Release 1998 



88 



ETSI TS 101 955 V7.2.0 (2001-09) 



6.2.4.17.4 



Test Coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17,20,21,25 


N4 


19,15 


N5 


16, 18,22 


N6 


23,24 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


11 


C1 


Does not apply for 
EnvelopeHandler 



6.2.5 Class EnvelopeResponseHandler 
6.2.5.1 Method getTheHandler 

Test Area Reference: API_2_ERH_GTHD 

6.2.5.1.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public static EnvelopeResponseHandler getTheHandler ( ) 

throws ToolkitException 

Normal execution 

CRRNl: The method shall return the single system instance of the EnvelopeResponseHandler class. 

CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object ( see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]) 

Parameter errors 
No requirements 

Context errors 

CRRCl: The method shall thrown ToolkitException (HANDLER_NOT_AV AIL ABLE) if the handler is busy. 

CRRC2: After the first invocation of the ProactiveHandler.send method the EnvelopeResponseHandler is no more 
available 



6.2.5.1.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test suite files 

API_2_ERH_GTHD_1 . scr 
API_2_ERH_GTHD_1 .j ava 
API_2_ERH_GTHD_1 .Idr 
API_2_ERH_GTHD_1 .clr 
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6.2.5.1.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler twice 


The returned objects shall be the 
same 




2 


Verify that getTheHandler returns an 
EnvelopeHandler 

getTheHandler 


The reference returned shall be an 

EnvelopeResponseHandler 

(checkcast) 




3 


Verify the returned value is not null 

getTheHandler 


The reference returned shall not be 
null. 




4 


getTheHandler, then send a proactive 
command, and then, appendTLV 


ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 





6.2.5.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


To be checked in 

Framework tests and 

insert here cross 

reference 


CI 


To be checked in 

Framework tests and 

insert here cross 

reference 


C2 


4 



6.2.5.2 Method post 

Test Area Reference: API_2_ERH_POSTB 

6.2.5.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void post (byte statusType) 
throws ToolkitException 

Normal execution 

CRRNl: When the method is called, the toolkit applet can continue it's processing (e.g. prepare a proactive 
command). 

CRRN2: The byte statusType is SWl of the status. 

CRRN3: If the send method is called after a post method, the posted data are the first sent to the ME. 

CRRN4: The SIM Toolkit Framework shall take the optional Application Data posted by the triggered toolkit applet 
if present, secure and send the response packet the SIM Toolkit Framework will return the response APDU 
defined by the toolkit applet. 

Parameter error 
No requirements 

Context errors 

CRRCl: The method shall thrown ToolkitException (HANDLER_NOT_AVAILABLE) if the handler is busy. 

6.2.5.2.2 Test suite files 
Specific triggering: Call control 
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Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.2.3 



API_2_ERH_POSTB_l .scr 
API_2_ERH_POSTB_l .Java 
API_2_ERH_POSTB_l .Idr 
API_2_ERH_POSTB_l .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler and then post 

(the handler is empty) 




9000 


2 


Fill the handler ( appendTLV to have bytes 

in it ) and then post data with status 
9F 




9FFD data are retrieved with GET 
RESPONSE command 


3 


Verify that after a post the handler is no 
more available 

appendTLV, post and then appendTLV 


ToolkitException 
HANDLER_NOT_AVAILABL 
E is thrown on the second 
appendTLV 




4 


construct the response (appendTLV with 

0x10 data) and post it with status 9E and 

then send a display text 




9E1 2 and posted data retrieved by a 
GET RESPONSE with status 91 1 3 
and display text retrieved by a FETCH 


5 


Verify that it is possible to send a proactive 
command after a post 

getTheHandler and post , then send a 
display text 




91 13 and display text is retrieved by 
a FETCH 


6 


Verify it is not possible to post after a 
proactive command 

getTheHandler, appendTLV, send a 
display text, post. 


ToolkitException 
HANDLER_NOT_AVAILABL 
E is thrown 




7 


Verify that the handler is no more available 
after a post 

getTheHandler, appendTLV, post with 
status 9E, post with status 9F 


ToolkitException 
HANDLER_NOT_AVAILABL 
E is thrown 


9E1 2 and posted data retrieved by a 
GET RESPONSE 



6.2.5.2.4 



Test Coverage 



GRR number 


Test case number 


N1 


3,4,7 


N2 


1,2,4,7 


N3 


4,5 


N4 


To be checked in 

Framework tests and 

insert here cross 

reference 


CI 


6 



6.2.5.3 Method postAsBERTLV 

Test Area Reference:API_2_ERH_P0STBB 

6.2.5.3.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void postAsBERTLV (byte statusType, 

byte tag) 
throws ToolkitException 

Normal execution 

CRRNl: When the method is called, the toolkit applet can continue it's processing (e.g. prepare a proactive 
command) the SIM Toolkit Framework will return the response APDU defined by the toolkit applet. 
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CRRN2: The byte statusType is SWl of the status 

CRRN3: If the send method is called after a postAsBERTLV method, the posted data are the first sent to the ME. 

CRRN4: The byte tag is the BER Tag at the beginning of the simple TLV list. 

Parameter errors 
No requirements 

Context errors 

CRRCl: The method shall thrown ToolkitException (HANDLER_NOT_AVAILABLE) if the handler is busy. 

6.2.5.3.2 Test suite files 

Specific triggering: Call control 

Test Script: API_2_ERH_POSTBB_l.scr 

Test Applet: API_2_ERH_POSTBB_l.java 

Load Script: API_2_ERH_POSTBB_l.ldr 

Cleanup Script: API_2_ERH_P0STBB_l.clr 



6.2.5.3.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler and then postAsBERTLV 

(the handler is empty) 




9F02 data are retrieved with 

GET RESPONSE command, 

the tag shall be 33 and the 

length is 00 


2 


Fill the handler and then postAsBERTLV 
the data with status 9F, and tag 33 




9FFF data are retrieved with 

GET RESPONSE command, 

the tag shall be 33 


3 


appendTLV, postAsBERTLV and then 
appendTLV 


ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown on the second appendTLV 




4 


construct the response (appendTLV with 

0x10 data) and postAsBERTLV it with 

status 9E, tag 75 and then send a display 

text 




9E14and posted data 

retrieved by a GET 

RESPONSE the tag shall be 

75 with status 91 13 and 

display text retrieved by a 

FETCH 


5 


getTheHandler and postAsBERTLV, then 
send a display text 




9E02 and posted data 

retrieved by a GET 

RESPONSE the tag 33 (and 

the length 00) with status 

9113 and display text is 

retrieved by a FETCH 


6 


Verify it is not possible to postAsBERTLV 
after a proactive command 

getTheHandler, appendTLV, send a 
display text, postAsBERTLV. 


ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown on the postAsBERTLV 




7 


Verify that the handler is no more available 
after a postAsBERTLV 

getTheHandler, appendTLV (with data 
length = 0x10, postAsBERTLV with status 
9E, tag 56, postAsBERTLV with status 
9F, tag 28 


ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown on the second postAsBERTLV 


9E14and posted data 

retrieved by a GET 

RESPONSE the tag shall be 

56 with status 9000 
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6.2.5.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,4,7 


N2 


1,2, 4, 7 


N3 


4,5 


N4 


2,4,7 


C1 


6 



6.2.5.4 Method getLength 

Test Area Reference: API_2_ERH_GLEN 

6.2.5.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

Normal execution 

CRRNl: returns the length in bytes of the TLV list. 

Parameter errors 
No requirements 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

6.2.5.4.3 Test Suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.4.3 



API_2_ERH_GLEN_1 .scr 
API_2_ERH_GLEN_1 .Java 
API_2_ERH_GLEN_1 .Idr 
API_2_ERH_GLEN_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear the handler 

getLength ( ) 


Result of getLengthO is 




2 


appendTLV with length of 7 

getLength () 


Result of getLengthO is 9 




3 


Clear the handler and appendTLV with Length 
of 250 

getLength () 


Result of getLengthO is 253 




4 


Build a 7Fh Envelope response handler 

getLength ( ) 


Result of getLengthO is 81 h 




5 


Build a 80h Envelope response handler 

getLength () 


Result of getLengthO is 83h 





Note : Test case 3 is limited to 253 and not 256 because the current 03.19 [7] is not clear enough on this point. So this 
test allows the two possible implementations. 
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6.2.5.4.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5 


C1 


Does not apply for 

Envelope response 

handler 



6.2.5.5 Method copy 

Test Area Reference: API_2_ERH_C0PY_BSS 



6.2.5.5.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang.NullPointerException, 

Java . lang, ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

CRRNl: copies the simple TLV list contained in the handler to the destination byte array. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null a NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, an 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if dstLength is greater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.5.3 Test Suite files 

Specific triggering: Unrecognized Envelope 
Test Script: API_2_ERH_COPY_BSS_l.scr 

Test Applet: API_2_ERH_COPY_BSS_Ljava 

Load Script: API_2_ERH_C0PY_BSS_l.ldr 

Cleanup Script: API_2_ERH_C0PY_BSS_l.clr 
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6.2.5.5.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with value length of 7 
NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 










dstOffset > dstBuffer.length 

dstBuffer . length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the simple TLV list 

dstBuffer.length = 10 
dstOffset = 
dstLength = 10 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

dstBuffer.length = 9 
dstOffset = 
dstLength = 9 


Result of copyQ is 9 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 9 


Result of copyO is 12 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyQ is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 




14 


Successful call, copy with length =0 

dstBuffer.length = 15 
dstOffset = 15 
dstLength = 


Result of copyQ is 15 





6.2.5.5.4 



Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12, 14 


PI 


1 


P2 


2,3,4,5,6 


P3 


7 


C1 


Does not apply for 

Envelope response 

handler 



6.2.5.6 Method findTLV 

Test Area Reference: API 2 ERH FINDBB 
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6.2.5.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV(byte tag, byte occurrence) 
throws ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag is 
set. 

CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension Required 
flag is not set. 

CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

CRRN5: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.6.3 Test Suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.6.3 



API_2_ERH_FINDBB_1 .scr 
API_2_ERH_FINDBB_l.java 
API_2_ERH_FINDBB_1 .Idr 
API_2_ERH_FINDBB_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








Invalid input parameter 

Occurrence = 


ToolkitException. BAD INPUT P 
ARAMETER is thrown 




2 










Search 1st TLV 

Tag = Olh 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result Is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 


Result is TLV_NOT_FOUND 
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Tag = 03h 
Occurrence = 1 






7 


Call the getValueLengthO method 


ToolkltException.UNAVAILABLE 
ELEMENT is thrown. 




8 


Search a tag with wrong occurrence 

Tag = Olh 
Occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


Tooll<itException.UNAVAILABLE 
ELEIVIENT is thrown. 




10 


Append a TLV with tag=02h 








Search the TLV 

Tag = 02h 
Occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Append a TLV with tag=04h 








Search the TLV 

Tag = 04h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 





6.2.5.6.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2,4 


N3 


10, 11 


N4 


6,7,8,9 


N5 


12, 13 


PI 


1 


CI 


Does not apply for 

Envelope response 

handler 



6.2.5.7 Method getValueLength 

Test Area Reference: API_2_ERH_GVLE 

6.2.5.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 

Normal execution 

CRRNl: gets and returns the binary length of the value field for the last TLV element which has been found in the 
handler. 

Parameter errors 
No requirements 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 
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6.2.5.7.3 Test Suite files 

Specific triggering: Unrecognized Envelope 
Test Script: API_2_ERH_GVLE_l.scr 

Test Applet: API_2_ERH_GVLE_l.java 

Load Script: API_2_ERH_GVLE_l.ldr 

Cleanup Script: API_2_ERH_GVLE_l.clr 



6.2.5.7.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV 02 02 02 02 
findTLV with TAG 03 








getValueLengthO 


ToolkitException.UNAVAILABLE 
_ELEMENT is thrown 




2 


appendTLV with TAG OD and length 00 








Search TLV ODh 








getValueLength ( ) 


Result is OOh 




3 


Clear the handler and append TLV with TAG 
OD and length 02 








Search TLV ODh 








getValueLength ( ) 


Result is 02h 




4 


Clear the handler and append TLV with TAG 
OD and length 0x7F 








Search TLV ODh 








getValueLengthO 


Result is 7Fh 




5 


Clear the handler and append TLV with TAG 
OD and length 0x80 








Search TLV ODh 








getValueLength ( ) 


Result is 80h 




6 


Clear the handler and append TLV with TAG 
OD and length OxFI 








Search TLV ODh 








getValueLength ( ) 


Result is Flh 





6.2.5.7.4 



Test Coverage 



CRR number 


Test case number 


N1 


2,3,4,5,6 


C1 


Does not apply for 

EnvelopeResponseHandl 

er 


C2 


1 



6.2.5.8 Method getValueByte 

Test Area Reference: API_2_ERH_GVBYS 

6.2.5.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 
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Normal execution 

CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 byte). 

Parameter errors 

CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.8.3 Test Suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.8.3 



API_2_ERH_GVB YS_1 .scr 
API_2_ERH_GVBYS_1 .Java 
API_2_ERH_GVB YS_1 .Mr 
API_2_ERH_GVB YS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV 82 02 81 82, appendlLV 81 03 1 1 

22 FE 

findTLV with TAG 03 








getValueByte (0) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h 








getValueByte (3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h 








getValueByte (2) 


Result is FEh 




4 


Search TLV 02h 








getValueByte (0) 


Result is 81 h 




5 


appendTLV with TAG OD, Length 0x7E, Value: 
00,01,...,7D 








getValueByte (7D) 


Result is 7Dh 




6 


clear the handler, appendTLV with TAG OD, 
Length 0x80, Value: 00, 01, ..., 7F 








getValueByte (7E) 


Result is 7Eh 




7 


getValueByte (7F) 


Result is 7Fh 




8 


clear the handler, appendTLV with TAG OD, 
Length OxFI , Value: 00, 01 , ..., FO 








getValueByte (FO) 


Result is FOh 
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6.2.5.8.4 



Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


CI 


Does not apply for 

EnvelopeResponseHandl 

er 


C2 


1 



6.2.5.9 Method copyValue 

Test Area Reference: API_2_ERH_CPYVS_BSS 

6.2.5.9.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue (short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.9.3 Test Suite files 

Specific triggering: Unrecognized Envelope 
Test Script: API_2_ERH_CPYVS_BSS_Lscr 

Test Applet: API_2_ERH_CPYVS_BSS_Ljava 

Load Script: API_2_ERH_CPYVS_BSS_Lldr 

Cleanup Script: API_2_ERH_CPYVS_BSS_Lclr 
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6.2.5.9.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: OD and length 16 
Select Text String TLV 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 










dstOffset > dstBuffer.length 

dstBuffer .length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Clear the handler, appendTLV with TAG: OD 

and length 6 

Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialise the handler 








copyValue () 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




12 


Clear the handler, appendTLV with TAG: OD 

and value: 04 00 01 ...OF 

Select Text String TLV 








Successful call 

valueOffset = 
dstBuffer.length = 17 
dstOffset = 
dstLength = 17 


Result of copyValueO is 17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

valueOffset = 2 
dstBuffer.length = 20 
dstOffset = 3 
dstLength = 12 


Result of copyValueO is 15 
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15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Successful call, copyValue with length =0 

dstBuffer. length = 20 
dstOffset = 20 
dstLength = 


Result of copyValueO is 20 





6.2.5.9.4 



Test Coverage 



CRR number 


Test case number 


N1 


13,15 


N2 


12, 14, 16 


PI 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


CI 


Does not apply for 

EnvelopeResponseHandl 

er 


C2 


11 



6.2.5.10 Method compareValue 

Test Area Reference: API_2_ERH_CPRVS_BSS 



6.2.5.10.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte[] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 

Normal execution 

Compares the last found TLV element with a buffer: 

CRRNl: returns if identical. 

CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 

CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 
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CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.10.3 Test Suite files 

Specific triggering: Unrecognized Envelope 
Test Script: API_2_ERH_CPRVS_BSS_l.scr 

Test Applet: API_2_ERH_CPRVS_BSS_l.java 

Load Script: API_2_ERH_CPRVS_BSS_l.ldr 

Cleanup Script: API_2_ERH_CPRVS_BSS_l.clr 



6.2.5.10.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: OD and length 16 
Select Text String TLV 








compareValueO with a null compareBuffer 


NullPointerException is thrown 




2 










compareOffset > compareBuffer.length 

compareBuffer . length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


appendTLV with TAG: OD and length 6 
Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialise the handler 








compareValue () 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




12 


appendTLV with TAG: OD and value: 04 00 01 
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...OF 
Select Text String TLV 








Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




13 


Initialise compareBuffer 

compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 
OE 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




15 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




16 


Initialise compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




18 


Successful call, compareValue with length =0 

compareBuf fer . length = 15 
compareOf f set = 15 
compareLength = 


Result of compareValueO is 





6.2.5.10.4 



Test Coverage 



CRR number 


Test case number 


N1 


12, 15, 18 


N2 


13,16 


N3 


14, 17 


PI 


1 


P2 


2,3,4,5,6 


PS 


7,8,9, 10 


CI 


Does not apply for 

EnvelopeResponseHandl 

er 


C2 


11 



6.2.5.1 1 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) 

Test Area Reference: API 2 ERH FACYB BS 
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6.2.5.11.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into a 
destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.11.3 Test Suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.11.3 



API_2_ERH_FACYB_BS_1 .scr 
API_2_ERH_FACYB_BS_1 .Java 
API_2_ERH_FACYB_BS_1 .Idr 
API_2_ERH_FACYB_BS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


appendTLV with TAG: OD and length 16 
Select Text String TLV 








dstOffset > dstBuffer.length 

tag = ODh 

dstBuffer.length = 20 
dstOffset = 20 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstOffset + length >dstBuffer.length 

dstBuffer.length = 20 
dstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


length > dstBuffer.length 

dstBuffer.length = 15 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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dstOffset = 






6 


clear the handler, appendTLV with TAG 02 
and Length 02 








Select a TLV (tag 02h) 








f indAndCopyValue () 
tag = 03h 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




7 


appendTLV with TAG: OD and value: 04 00 01 
...OF 








Successful call 

Tag = ODh 

dstBuffer. length = 17 

dstOffset = 


Result of fincJAndCopyValueO is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




9 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

dstBuffer. length = 20 
dstOffset = 2 


Result of findAndCopyValueO is 
19 




10 


Compare buffer 

buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




11 


clear the handler, appendTLV with TAG: OD 
and value: 04 00 01 ...OF 








append a 2"" Text String TLV 








Successful call 

tag = ODh 

dstBuffer .length = 17 

dstOffset = 


Result of findAndCopyValueO is 
17 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




13 


clear the handler, appendTLV with TAG: OD 
and value: 04 00 01 ...OF 








Successful call (with tag 8Dh) 

tag = 8Dh 

dstBuffer. length = 17 

dstOffset = 


Result of findAndCopyValueO is 
17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




15 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

dstBuffer .length = 16 

dstOffset = 


Result of findAndCopyValueO is 
16 




16 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 
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6.2.5.11.4 



Test Coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 

EnvelopeResponseHandl 

er 



6.2.5.12 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 



Test Area Reference: API 2 ERH FACYBBS BSS 



6.2.5.12.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
Toolkit Except ion 

Normal execution 

CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.12.3 Test Suite files 

Specific triggering: Unrecognized Envelope 
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Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.12.3 



API_2_ERH_FACYBBS_BSS_1 .scr 
API_2_ERH_FACYBBS_BSS_1 .Java 
API_2_ERH_FAC YBBS_BSS_1 .Idr 
API_2_ERH_FACYBBS_BSS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCopyValueQ with a null dstBuffer 


NullPointerException is thrown 




2 


appendTLV with TAG: OD and length 16 








dstOffset > dstBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


appendTLV with TAG: OD and length 6 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkltException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkltException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkltException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkltException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Clear the handler, appendTLV with TAG 02 
and Length 02 








Select a TLV (tag 02h) 








f indAndCopyValue () 
tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
_ELEIVIENT is thrown 






Call the getValueLength method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




12 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 17 


Result of findAndCopyValueO is 
17 
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dstOffset = 
dstLength = 17 






13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 2 
dstBuffer .length = 20 
dstOffset = 3 
dstLength = 12 


Result of findAndCopyValueO is 
15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOli 




16 


Append a Text String TLV 

tag = OD 

buffer = 00 11 22 33 44 55 (no specific 

DCS byte) 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer .length = 20 
dstOffset = 
dstLength = 17 


Result of findAndCopyValueO is 
17 




17 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




18 


Successful call 

tag = ODh, occurrence = 2 
valueOffset = 
dstBuffer .length = 6 
dstOffset = 
dstLength = 6 


Result of findAndCopyValueO is 
6 




19 


Compare buffer 

buffer = 00 11 22 33 44 55 


Result is OOh 




20 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 
occurrence = 1 
valueOffset = 
dstBuffer .length = 17 
dstOffset = 
dstLength = 17 


Result of findAndCopyValue () is 
17 




21 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




22 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 
occurrence = 1 
valueOffset = 
dstBuffer .length = 16 
dstOffset = 
dstLength =16 


Result of findAndCopyValue () is 
16 




23 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 




24 


Successful call, findAndCopyValue with 
length =0 

dstBuffer .length = 16 
dstOffset = 16 
dstLength = 


Result of findAndCopyValue () is 
16 
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6.2.5.12.4 



Test Coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18,24 


N4 


20,21, 22,23 


P1 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


CI 


Does not apply for 

EnvelopeResponseHandl 

er 



6.2.5.13 Method findAndCompareValue(byte tag, byteQ compareBuffer, short 
compareOffset) 



Test Area Reference: API_2_ERH_FACRB_BS 



6.2.5.13.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws Java . lang. NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion. 
Toolkit Except ion 

Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 

CRRN3: if identical returns 0. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -I. 

CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns L 

CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 

6.2.5.13.3 Test Suite files 

Specific triggering: Unrecognized Envelope 

Test Script: API_2_ERH_FACRB_BS_Lscr 
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Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.13.3 



API_2_ERH_FACRB_BS_1 .Java 
API_2_ERH_FACRB_BS_1 .Mr 
API_2_ERH_FACRB_BS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: OD and length 16 








findAndCompareVaiueQ with a null dstBuffer and 
tag ODh 


NullPointerException is thrown 




2 










compareOffset > compareBuffer.length 

tag = ODh 

compareBuffer.length = 20 
compareOffset = 20 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareOffset + length > 
compareBuffer.length 

compareBuffer.length = 20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


length > compareBuffer.length 

compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Clear the handler, appendTLV with TAG 02 
and Length 02 








Select a TLV (tag 02h) 








f IndAndCompareValue () 
tag = 03h 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 




7 


Verify current TLV 

getValueLength ( ) 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




8 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Initialise compareBuffer 

compareBuf fer = 
04 00 01 ... OF 








Compare buffers 

tag = ODh 
compareOffset = 


Result is OOh 




9 


Verify current TLV 

getValueLength ( ) 


Result is 17 




10 


Initialise compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




11 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




12 


Initialise compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOffset = 2 


Result is OOh 




13 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialise compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 


Result is OOh 
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compareOf f set = 2 






14 


Initialise compareBuffer 

compareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOffset = 2 


Result is -1 




15 


Initialise compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

compareOffset = 2 


Result is +1 




16 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 

compareBuf fer . length = 17 

compareOffset = 


Result is OOh 




17 


Append tag OFh 

buffer = 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag BFh) 

tag = 8Fh 

compareBuf fer . length =16 

compareOffset = 


Result is OOh 





6.2.5.13.4 



Test Coverage 



CRR number 


Test case number 


N1 


6,7 


N2 


7,9 


N3 


8, 13, 12 


N4 


10, 14 


N5 


11, 15 


N6 


17, 16 


PI 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 

Envelope response 

handler 



6.2.5.14 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 



Test Area Reference: API 2 ERH FACRBBS BSS 



6.2.5.14.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] compareBuffer, 
short compareOffset, 
short compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 
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Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 

CRRN3: if identical is returned. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 

CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 

CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. The 
reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.14.3 Test Suite files 

Specific triggering: Unrecognized Envelope 
Test Script: API_2_ERH_FACRBBS_BSS_l.scr 

Test Applet: API_2_ERH_FACRBBS_BSS_l.java 

Load Script: API_2_ERH_FACRBBS_BSS_l.ldr 

Cleanup Script: API_2_ERH_FACRBBS_BSS_l.clr 
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6.2.5.14.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCompareVaiueQ with a null 
compareBuffer 


NullPointerException is thrown 




2 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








compareOffset > compareBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


clear the handler and appendTLV with TAG 
and length of 6 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


ToolkitException.BAD INPUT P 
ARAMETER is thrown 




12 


appendTLV with TAG 02 and length 02 








Select a TLV (tag 02h) 








f IndAndCompareValue () 
tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
_ELEIVIENT is thrown 




13 


Verify current TLV 

getValueLength ( ) 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




14 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareVaiueQ 

tag = ODh, occurrence = 1 


Result is OOh 
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valueOffset = 
compareOf f set = 
compareLength = 17 






15 


Verify current TLV 

getValueLength ( ) 


Result is 17 




16 


Initialise compareBuffer 

compareBuf fer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




17 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




18 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




19 


Initialise compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




20 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




21 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




22 


Initialise compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




23 


Initialise compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is -1 




24 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh, occurrence = 1 
valueOffset = 
compareBuf fer . length = 17 
compareOf f set = 
compareLength = 17 


Result is OOh 
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25 


Append tag OFh 

buffer = 00 01 ... OF 








Initialise compareBuffer 

compareBuf fer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh, occurrence = 1 
valueOffset = 
compareBuf fer . length = 16 
compareOf f set = 
compareLength = 16 


Result is OOh 




26 


Successful call, findAndCompareValue with 
length =0 

CompareBuf fer . length = 16 
compareOf f set =16 
compareLength = 


Result of findAndCompareValue 
is 00 





6.2.5.14.4 



Test Coverage 



CRR number 


Test case number 


N1 


12,13 


N2 


15,13 


N3 


14, 18,22,21,26 


N4 


16, 19,23 


N5 


17, 19 


N6 


25,24 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


11 


C1 


Does not apply for 

EnvelopeResponseHandl 

er 



6.2.5.15 Method appendArray 

Test Area Reference: API_2_ERH_APDA_BSS 

6.2.5.15.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendArray (byte [ ] buffer, short offset, short length) 
throws Java . lang . NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion, 
ToolkitException 

Normal execution 

CRRNl: appends a buffer into the EditHandler buffer 
CRRN2: a successful append does not modify the TLV selected 

Parameters error 

CRRPl: if buffer is null, a java.lang.NullPointerException is thrown 

CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER OVERFLOW 
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CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

6.2.5.15.2 Test suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.15.3 



API_2_ERH_APDA_BSS_1 .scr 
API_2_ERH_APDA_BSS_1 .Java 
API_2_ERH_APDA_BSS_1 .Idr 
API_2_ERH_APDA_BSS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Initialize the envelope response handler with a 
TLV of length 1 






1 


Null buffer 


NullPointerException is thrown 




2 


offset > buffer.length 

buf fer . length = 5 
offset = 5 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


Offset < 

buffer.length = 5 
offset = -1 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

buffer.length = 5 
offset = 
length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer.length = 5 
offset = 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

buffer.length = 256 
offset = 
length = 256 


ToolkitException. HANDLER OV 
ERFLOW is thrown 




8 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








findlLV 0x81 








Successful call 

buffer = FF FE ... F8 
offset = 
length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




9 


Clear the handler 








Successful call 

buffer = FF FE ... F8 
offset = 
length = 8 








Call copyO method 








Compare handler 

compareBuf fer = FF FE ... F8 


Result is OOh 




10 


Successful call 

buffer = 00 01 ... 07 
offset = 2 
length = 6 








Call copyO method 








Compare handler 

compareBuffer = FF FE ... F8 02 03 ... 07 


Result is OOh 




11 


Successful call 
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buffer = 11 22 ... 88 
offset = 2 
length = 4 








Call copyO method 








Compare handler 

compareBuffer = FF FE ... F8 02 03 ... 07 33 

44 55 66 


Result is OOh 





6.2.5.15.4 



Test Coverage 



CRR number 


Test case number 


N1 


9, 10, 11 


N2 


8 


N3 




P1 


1 


P2 


2,3,4,5,6 


C1 


7 


C2 


Does not apply for 

EnvelopeResponseHandl 

er 



6.2.5.1 6 Method appendTLV(byte tag, byte value) 

Test Area Reference: API_2_ERH_APTLBB 

6.2.5.16.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, byte value) 
throws ToolkitException 

Normal execution 

CRRNl: Appends a TLV element to the current TLV list (1-byte element). 
CRRN2; A successful append does not modify the TLV selected. 

Parameters error 
No requirements 

Context errors 

CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

6.2.5.16.2 Test suite files 
Specific triggering: Unrecognized Envelope 

Test Script: API_2_ERH_APTLBB_l.scr 

Test Applet: API_2_ERH_APTLBB_l.java 

Load Script: API_2_ERH_APTLBB_l.ldr 

Cleanup Script: API_2_ERH_APTLBB_l.clr 
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6.2.5.16.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArrayO 

length = 253 








Handler Overflow: Call twice the 
appendTLV()method 


ToolkitException.HANDLER_OV 
ERFLOW is thrown by one of the 
two. 




2 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call the appendTLVQ method 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




3 


Clear the handler 








Successful call 

tag = 84h 
value = OOh 








Call copyO method 








Compare handler 

compareBuffer = 84 01 00 


Result is OOh 




4 


Successful call 

tag = Olh 
value = FEh 








Call copyO method 








Compare handler 

compareBuffer = 84 01 00 01 01 FE 


Result is OOh 





Note : Test case 1 call twice appendTLV because the current 03.19 [7] is not clear enough on this point. So this test 
allows the two possible implementations. 



6.2.5.16.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


C1 


1 


C2 


Does not apply for 

EnvelopeResponseHandl 

er 



6.2.5.1 7 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: API_2_ERH_APTLBBB 

6.2.5.17.1 Conformance requirements: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, byte valuel, byte value2) 
throws ToolkitException 

Normal execution 

CRRNl: Appends a TLV element to the current TLV list (2-byte element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 
No requirements 
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Context errors 

CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE 



6.2.5.17.2 Test suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.17.3 



API_2_ERH_APTLBBB_Lscr 
API_2_ERH_APTL BBB_Ljava 
API_2_ERH_APTL BBB_Lldr 
API_2_ERH_APTLBBB_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArray with length of 253 








Handler Overflow: Call the appendTLVQ 
method 


ToolkitException. HANDLER OV 
ERFLOW is thrown 




2 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




3 


Clear the handler 








Successful call 

tag = 84h 
valuel = OOh 
value2 = Olh 








Call copyO method 








Compare handler 

compareBuffer = 84 02 00 01 


Result is OOh 




4 


Successful call 

tag = Olh 
valuel = FEh 
value2 = FDh 








Call copyO method 








Compare handler 

compareBuffer = 84 02 00 01 01 02 FE FD 


Result is OOh 





6.2.5.17.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


C1 


1 


C2 


Does not apply for 

EnvelopeResponseHandl 

er 



6.2.5.18 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short valuelength) 

Test Area Reference: API 2 ERH APTLB BSS 
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6.2.5.18.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte [ ] value, 
short valueoffset, 
short valuelength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

CRRNl: Appends a TLV element to the current TLV list (byte-array element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

CRRPl: if value is null, a java.lang.NuUPointerException is thrown 

CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is negative, a 
java.lang. ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER 

6.2.5.18.2 Test suite files 
Specific triggering: Unrecognized Envelope 

Test Script: API_2_ERH_APTLB_BSS_l.scr 

Test Applet: API_2_ERH_APTLB_BSS_l.java 

Load Script: API_2_ERH_APTLB_BSS_l.ldr 

Cleanup Script: API_2_ERH_APTLB_BSS_l.clr 
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6.2.5.18.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value 


NullPointerException is thrown 




2 


valueOffset > value.length 

value. length = 5 
valueOffset = 5 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


valueOffset < 

value.length = 5 
valueOffset = -1 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


valueLength > value.length 

value.length = 5 
valueOffset = 
valueLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


ValueOffset + valueLength > value.length 

value.length = 5 
valueOffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

value.length = 5 
valueOffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value.length = 254 
valueOffset = 
valueLength = 254 


ToolkitException. HANDLER OV 
ERFLOW is thrown 




8 


Bad parameter 

value.length = 256 
valueOffset = 
valueLength = 256 


ToolkitException. BAD INPUT P 
ARAMETER is thrown 




9 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Successful call 

tag = 04 

value = FF FE ... F8 
valueOffset = 
valueLength = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




10 


Clear the handler 








Successful call 

tag = 04 

value = FF FE ... F8 
valueOffset = 
valueLength = 8 








Call copyO method 








Compare handler 

CompareBuf fer = 04 08 FF FE ... F8 


Result Is 00 




11 


Successful call 

tag = 85h 
value = 00 01 ... 07 
valueOffset = 2 
valueLength = 6 








Call copvO method 








Compare handler 

compareBuffer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 


Result is 00 




12 


Successful call 

tag = 01 

value = 11 22 ... 88 
valueOffset = 2 
valueLength = 4 








Call copyO method 








Compare handler 

compareBuffer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 01 04 33 44 55 66 


Result is 00 




13 


Clear the handler 








Successful call 

tag = 04 
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value = 00 01 ... 7F 
valueOffset = 
valueLength = 80h 








Call copyO method 








Compare handler 

compareBuffer = 04 81 80 00 01. ..7F 


Result is 00 





6.2.5.18.4 



Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13 


N2 


9 


P1 


1 


P2 


2,3,4,5,6 


C1 


7 


C2 


Does not apply for 

EnvelopeResponseHandl 

er 


C3 


8 



6.2.5.1 9 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 
short value2length) 



Test Area Reference: API 2 ERH APTLBB BSS 



6.2.5.19.1 



Conformance requirement: 



The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte valuel 
byte [ ] value2, 
short value2of f set , 
short value21ength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 

Normal execution 

CRRNl: Appends a TLV element to the current TLV list (1 byte and a byte-array element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

CRRPl: if value2 is null, a Java. lang. NullPointerException is thrown 

CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, a Java. lang. ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD INPUT PARAMETER 
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6.2.5.19.2 Test suite files 

Specific triggering: Unrecognized Envelope 
Test Script: API_2_ERH_APTLBB_BSS_l.scr 

Test Applet: API_2_ERH_APTLBB_BSS_l.java 

Load Script: API_2_ERH_APTLBB_BSS_l.ldr 

Cleanup Script: API_2_ERH_APTLBB_BSS_l.clr 



6.2.5.19.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value2 


NullPointerException is thrown 




2 


value20ffset > value2.length 

value2 . length = 5 
value20ffset = 5 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


value20ffset < 

value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


value2Length > value2.length 

value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


value20ffset + value2Length > value2.length 

value2 . length = 5 
value20ffset = 3 
value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


value2Length < 

value2 . length = 5 
value20ffset = 
value2Length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value2 .length = 254 
value20ffset = 
value2Length = 254 


ToolkitException. HANDLER OV 
ERFLOW is thrown 




8 


Bad parameter 

value2 . length = 256 
value20ffset = 
value2Length = 256 


ToolkitException. BAD INPUT P 
ARAMETER is thrown 




9 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Successful call 

tag = 04 
valuel = 05 
value2 = FF FE ... F8 
value20ffset = 
value2Length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




10 


Clear the handler 








Successful call 

tag = 04 
valuel = 05 
value2 = FF FE ... F8 
value20ffset = 
value2Length = 8 








Call copyO method 








Compare handler 

CompareBuffer = 04 09 05 FF FE ... F8 


Result is 00 




11 


Successful call 

tag = 85h 
valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 
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Call copyO method 








Compare handler 

CompareBuf fer = 

04 09 05 FF FE ... F8 

85 07 55 02 03 ... 07 


Result is 00 




12 


Successful call 

tag = 01 
valuel = 44h 
value2 = 11 22 ... 88 
value20ffset = 2 
value2Length = 4 








Call copyO method 








Compare handler 

CompareBuf fer = 
04 09 05 FF FE ... F8 
85 07 55 02 03 ... 07 
01 05 44 33 44 55 66 


Result is 00 




13 


Clear the handler 








Successful call 

tag = 04 
valuel = 00 
value2 = 01 ... 7F 
value20ffset = 
value2Length = 7Fh 








Call copyO method 








Compare handler 

CompareBuf fer = 04 81 80 00 01. ..7F 


Result is 00 





6.2.5.19.4 



Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13 


N2 


9 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


7 


C2 


Does not apply for 

EnvelopeResponseHandl 

er 


C3 


8 



6.2.5.20 Method clear 

Test Area Reference: API_2_ERH_CLER 

6.2.5.20.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void clear ( ) 

throws ToolkitException 

Normal execution 

CRRNl: Clears the TLV list of an EditHandler and resets the current TLV selected. 

Parameters error 
No requirements 

Context errors 

CRRCl: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE 
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Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.5.20.3 



API_2_ERH_CLER_1 .scr 
API_2_ERH_CLER_1 .Java 
API_2_ERH_CLER_1 .Idr 
API_2_ERH_CLER_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 

Select Command Details TLV 
Call the getLengthO method 


Result of getLengthO is not null 






Clear the handler 

Call the getLengthO method 


Result of getLengthO is 




2 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 





6.2.5.20.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2 


C1 


Does not apply for 

EnvelopeResponseHandl 

er 



6.2.6 Class MEProfile 
6.2.6.1 Method check (byte index) 

Test Area Reference: API_2_MEP_CHECB 

6.2.6.1.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static boolean check (byte index) 
throws ToolkitException 

Normal execution 

CRRNl: The method checks a facility in the handset profile: returns true if supported and false if not. 

Parameters error 

CRRPl: The method shall throw ME_PROFILE_NOT_A VAIL ABLE ToolkitException if Terminal Profile data are 
not available 

Context errors 
No requirements 
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6.2.6.1.2 Test suite files 

Specific triggering: 

UNFORMATTED_SMS_PP_UPD 
No Additional requirements for the GSM personalisation: 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.6.1.3 



API_2_MEP_CHECB_1 .scr 

API_2_MEP_CHECB_1 .Java 

API_2_MEP_CHECB_1 .Idr (the applet is loaded without INI after the reset (RST) 

API_2_MEP_CHECB_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by unformatted SMS 
Index = 1 


ME_PROFILE_NOT_AVAILABLE 
ToolkitException is thrown 




2 


Terminal Profile, Facility is supported 

index = 


true is returned by the method 




3 


Terminal Profile, Facility is not supported 

Index = 15 


false is returned by the method 





6.2.6.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


2,3 


P1 


1 



6.2.6.2 Method check (byte [ ] mask, short offset, short length) 

Test Area Reference: API_2_MEP_CHEC_BSS 



6.2.6.2.1 



Conformance requirement: 



The method with following header shall compliant to its definition in the API. 

public static boolean check (byte [] mask, 

short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java .lang . Array IndexOutOfBoundsExcept ion, 
ToolkitException 

Normal execution 

CRRNl: The method checks all the facilities corresponding to bits set to 1 in the mask buffer: returns true if they 
are all supported and false if not. 

CRRN2: The method returns true if the length to check is 0. 

Parameters error 

CRRPl: The method shall throw java.lang.NullPointerException if mask is null. 

CRRP2: The method shall throw java.lang.ArraylndexOutOfBoundsException if offset or length or both would 
cause access outside array bounds. 

CRRP3: The method shall throw ME_PROFILE_NOT_A VAIL ABLE ToolkitException if Terminal Profile data ai-e 
not available. 



ETSI 



3GPP TS 1 1 .1 3 version 7.2.0 Release 1 998 1 27 ETSI TS 1 01 955 V7.2.0 (2001 -09) 

Context errors 
No requirements 

6.2.6.2.2 Test suite files 

Specific triggering: 

UNFORMATTED_SMS_PP_UPD 
No Additional requirements for the GSM personalisation: 

Test Script: API_2_MEP_CHEC_BSS_l.scr 

Test Applet: API_2_MEP_CHEC_BSS_l.java 

Load Script: API_2_MEP_CHEC_BSS_1 .Idr (the applet is loaded without INI after the reset (RST)) 

Cleanup Script: API_2_MEP_CHEC_BSS_l.clr 
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6.2.6.2.3 



Test procedure 



Id 


Description 


API Expectation 


APDU 
Expectation 


1 


No Terminal Profile is registered 

Triggered by unformatted SMS 

Mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

Offset = 

Length = 16 


ME_PROFILE_NOT_AVAIL 
ABLE ToolkitException is 
thrown 




2 


NULL as parameter to check 

mask= NULL 


NullPointerException is 
thrown 




3 


Offset > mask.length 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
Offset = 17 


ArraylndexOutOfBoundsExc 
option is thrown 




4 


Offset < 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
Offset = -1 


ArraylndexOutOfBoundsExc 
option is thrown 




5 


Length > mask.length 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
Offset = 
Length =18 


ArraylndexOutOfBoundsExc 
option is thrown 




6 


Offset + length > mask.length 

Mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
Offset = 9 
Length = 9 


ArraylndexOutOfBoundsExc 
option is thrown 




7 


length = 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
Offset = 
Length = 


true is returned 




8 


Check all the Terminal Profile 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
Offset = 
Length =16 


false is returned by the 
method because facility 15 is 
not supported 




9 


Check a part of the Terminal Profile 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
Offset = 15 
Length = 2 


true is returned by the 
method: the 16 first facilities 
except facility 15 have been 
successfully checked 




10 


Check a part of the Terminal Profile 

mask = 0x0080 
Offset = 
Length = 2 


false is returned by the 
method only facility 15 is 
checked and not supported. 





6.2.6.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


8,9,10 


N2 


7 


PI 


2 


P2 


3,4,5,6 


P3 


1 



6.2.7 Class ProactiveHandler 
6.2.7.1 Method getTheHandler 

Test Area Reference: API_2_PAH_GTHD 

6.2.7.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ProactiveHandler getTheHandler ( ) 

throws ToolkitException 
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Normal execution 

CRRNl: The method shall return the single system instance of the ProactiveHandler class. 
CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object 

Parameter errors 
No requirements 

Context errors 

CRRCl: The method shall throw ToolkitException.HANDLER_NOT_AVAILABLE if the handler is busy. 



6.2.7.1.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.7.1.3 



Test Suite files 

API_2_PAH_GTHD_1 . scr 
API_2_PAH_GTHD_1 .j ava 
API_2_PAH_GTHD_1 .Idr 
API_2_PAH_GTHD_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandlerQ twice 


The returned objects shall be the 
same 




2 


getTheHandlerO 


The reference shall be a 
ProactiveHandler 




3 


getTheHandlerO 


The reference shall not be null 





6.2.7.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


To be checked in 

Framework tests and 

insert here cross 

reference 


CI 


To be checked in 

Framework tests and 

insert here cross 

reference 



6.2.7.2 Method init 

Test Area Reference: API_2_PAH_INITBBB 

6.2.7.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void init (byte type, 

byte qualifier, 
byte dstDevice) 



£75/ 



3GPP TS 11.13 version 7.2.0 Release 1998 



130 



ETSI TS 101 955 V7.2.0 (2001-09) 



Normal execution 

CRRNl: The init() method initiaHses the next Proactive command in the ProactiveHandler, with Command details 
and Device Identities TLV. The source device is always the SIM Card (81h). The Comprehension Required flags 
are set. 

CRRN2: The Command number may take any value between Olh and FEh. 

CRRN3: The init() method clears the ProactiveHandler before initialising it. 

CRRN4: No TLV is selected after a call to the method. 

CRRN5: The handler is not sent to the mobile by the init() method. 



Parameter errors 
No requirements 

Context errors 
No requirements 

6.2.7.2.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.7.2.3 



Test Suite files 

API_2_PAH_INITBBB_Lscr 
API_2_PAH_INITBBB_1 .j ava 
API_2_PAH_INITBBB_1 .Idr 
API_2_PAH_INITBBB_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the initO method 

type = Olh 
qualifier = 02h 
dstDevice = 03h 

Copy ProactiveHandler in a byte array 

(source) 

Compare the byte array 

reference = 

81h 03h xxh Olh 02h 

82h 02h 81h 03h 


source and reference are 
identical 




2 


Verify the command number value 


01h-FEh 




3 


Call the initO method 

type = FFh 
qualifier = FEh 
destination = FDh 

Copy ProactiveHandler in a byte array 

(source) 

Compare the byte array 

reference = 

81h 03h xxh FFh FEh 

82h 02h 81h FDh 


source and reference are 
identical 




4 


Select the 1st TLV in the handler 
Call the init() method with any value 








Call the getValueLengthO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthO 
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6.2.7.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,3 


N2 


2 


N3 


3 


N4 


4 


N5 


1,3 



6.2.7.3 Method initDisplayText 

Test Area Reference: API_2_PAH_INDTBB_BSS 

6.2.7.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initDisplayText (byte qualifier, 

byte dcs, 
byte [ ] buffer, 
short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

CRRNl: The method shall build a DISPLAY TEXT proactive command in the ProactiveHandler, using qualifier, 
dcs and buffer parameters. Comprehension required flags are set. 

CRRN2: A call to this method clears the handler then initialises it. 

CRRN3: No TLV is selected after a call to the method. 

CRRN4: The DISPLAY TEXT command is not sent by the method. 

CRRN5: The Command Number may take any value between Olh and FEh. 

Parameter errors 

CRRPl: The method shall throw NullPointerException if buffer is null. 

CRRP2: If offset or length or both would cause access outside array bounds, an ArraylndexOutOfBoundsException 
shall be thrown. 

Context errors 

CRRCl: A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is too small to put 
the requested data. 



6.2.7.3.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PAH_INDTBB_BSS_1 .scr 
API_2_PAH_INDTBB_BSS_1 .Java 
API_2_PAH_INDTBB_BSS_1 .Idr 
API 2 PAH INDTBB BSS Lclr 
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6.2.7.3.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

buffer = NULL 


NullPointerException is thrown 




2 


offset > buffer.length 

buffer = "Text" 
offset = 5 
length = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


Offset < 

buffer = "Text" 

offset = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


length > buffer.length 

buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


Offset + length > buffer.length 

buffer = "Text" 
offset = 3 
length = 2 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer = "Text" 
offset = 3 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Successful call, buffer is the whole buffer 

qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 




8 


Send the command 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextA" 


9 


Succesfull call, buffer is part of a buffer with 

the end part 

Send the command 

qualifier = 
dcs = 4 

buffer = "12TextB" 
offset = 2 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextB" 


10 


Succesfull call, buffer is part of a buffer with 

the first part 

Send the command 

qualifier = 
dcs = 4 

buffer = "TextC12" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextC" 


11 


Succesfull call, buffer is part of a buffer 
Send the command 




DISPLAY TEXT Proactive 
command 




qualifier = 

dcs = 4 

buffer = "12TextD34" 

offset = 2 

length = 5 




qualifier = OOh 

dcs = 4 

Text = "TextD" 


12 


Succesfull call, qualifier = 81h 
Send the command 

qualifier = 81h 
dcs = 4 

buffer = "TextE" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = 81h 

dcs = 4 

Text = "TextE" 


13 


Succesfull call, DCS=0 (7 bits) 
Send the command 




DISPLAY TEXT Proactive 
command 




qualifier = 
dcs = 

buffer = "TextF" 
offset = 




qualifier = OOh 

dcs = 

Text = "TextF" 
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length = 5 






14 


Succesfull call, DCS=8 (UCS2) 
Send the command 

qualifier = 
dcs = 8 

buffer = "TextG" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

dcs = 8 

Text = "TextG" 


15 


Call the JnitDlsplayTextQ method with any 

value 

Then build and send a DISPLAY TEXT 

command 

qualifier = 

dcs = 4 

buffer = "TextHTextH" 

offset = 

length = 10 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextHTextH" 


16 


Successful call, text length is null 
Send the command 

qualifier = 

dcs = 4 

buffer = "" (not null buffer) 

offset = 

length = 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

Text String TLV = 8D 00 


17 


Select a TLV in the ProactiveHandler 
Call the initDisplayTextO method 
Call the getValueLengthO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthO 




18 


Successful call, buffer length = 7Eh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Eh 




DISPLAY TEXT Proactive 
command 

Text String TLV = 
8D 7F 04 55 55... 


19 


Successful call, buffer length = 7Fh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Fh 




DISPLAY TEXT Proactive 
command 

Text String TLV = 8D 81 
80 04 55 55... 


20 


Successful call, buffer length = 240 

Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 240 




DISPLAY TEXT Proactive 
command 

Text String TLV = 
8D 81 Fl 04 55 55... 


21 


Call the initDisplayTextO method with a too 
long buffer 

qualifier = 
dcs = 4 

buffer = "XXXX..." 
offset = 
length = 241 


HANDLER_OVERFLOW 
ToolkitException is thrown 




22 


Call the InitDisplayTextO without sending the 
command 




No proactive command 
shall be sent expected 
status is '9000' 
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6.2.7.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


8,9, 10, 11, 12, 13, 14, 
15, 16, 18, 19,20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


21 



6.2.7.4 Method initGetlnkey 

Test Area Reference: API_2_PAH_INGKBB_BSS 



6.2.7.4.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public void initGetlnkey (byte qualifier^ 

byte dcs, 
byte [ ] buffer, 
short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 



Normal execution 

CRRNl: The method shall build a GET INKEY proactive command in the ProactiveHandler, using qualifier, dcs 
and buffer parameters. Comprehension Required flags are set. 

CRRN2: A call to this method clears the handler then initialises it. 

CRRN3: No TLV is selected after a call to the method. 

CRRN4: The GET INKEY command is not sent by the method. 

CRRN5: The Command Number may take any value between Olh and FEh. 

Parameter errors 

CRRPl: The method shall throw NullPointerException if buffer is null. 

CRRP 1 : If offset or length or both would cause access outside array bounds, a ArraylndexOutOfBoundsException 
shall be thrown. 

Context errors 

CRRCl: A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is to small to put 
the requested data. 



6.2.7.4.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PAH_INGKBB_BSS_1 .scr 
API_2_PAH_INGKBB_BSS_1 .Java 
API_2_PAH_INGKBB_BSS_1 .Idr 
API_2_PAH_INGKBB_BSS_1 .clr 



£75/ 



3GPP TS 11.13 version 7.2.0 Release 1998 



135 



ETSI TS 101 955 V7.2.0 (2001-09) 



6.2.7.4.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

buffer = NULL 


NullPointerException is thrown 




2 


offset > buffer.length 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is tlirown 






offset = 5 






3 


Offset < 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is tlirown 






offset = -1 






4 


length > buffer.length 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = 








length = 5 






5 


Offset + length > buffer.length 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = 3 








length = 2 






6 


length < 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = 3 








length = -1 






7 


Successful call, buffer is the whole buffer 

qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 




8 


Send the command 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextA" 


9 


Succesfull call, buffer is part of a buffer with 




GET INKEY Proactive 




the end part 




command 




qualifier = 








dcs = 4 




qualifier = OOh 




buffer = "12TextB" 




dcs = 4 




offset = 2 




Text = "TextB" 




length = 5 






10 


Succesfull call, buffer is part of a buffer with 




GET INKEY Proactive 




the first part 




command 




qualifier = 








dcs = 4 




qualifier = OOh 




buffer = "TextC12" 




dcs = 4 




offset = 




Text = "TextC" 




length = 5 






11 


Succesfull call, buffer is part of a buffer 




GET INKEY Proactive 




Send the command 




command 




qualifier = 








dcs = 4 




qualifier = OOh 




buffer = "12TextD34" 




dcs = 4 




offset = 2 




Text = "TextD" 




length = 5 






12 


Succesfull call, qualifier = 81h 




GET INKEY Proactive 




qualifier = 81h 




command 




dcs = 4 








buffer = "TextE" 




qualifier = 81h 




offset = 




dcs = 4 




length = 5 




Text = "TextE" 


13 


Succesfull call, DCS=0 (7 bits) 




GET INKEY Proactive 




qualifier = 




command 




dcs = 








buffer = "TextF" 




qualifier = OOh 




offset = 




dcs = 




length = 5 




Text = "TextF" 


14 


Succesfull call, DCS=8 (UCS2) 




GET INKEY Proactive 




qualifier = 




command 
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dcs = 8 

buffer = "TextG" 
offset = 
length = 5 




command 

qualifier = OOh 

dcs = 8 

Text = "TextG" 


15 


Call the initGetlnkeyO method with any value 
Then build and send a GET INKEY command 

qualifier = 

dcs = 4 

buffer = "TextHTextH" 

offset = 

length = 10 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextHTextH" 


16 


Successful call, text length is null 
Send the command 

qualifier = 
dcs = 4 
buffer = "" 
offset = 
length = 




GET INKEY Proactive 
command 

qualifier = OOh 

Text String TLV = 8D 00 


17 


Select a TLV in the ProactiveHandler 

Call the initGetlnkeyO method 

Call the getValueLengthO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthO 




18 


Successful call, buffer length = 7Eh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Eh 




GET INKEY Proactive 
command 

Text String TLV = 
8D 7F 04 55 55... 


19 


Successful call, buffer length = 7Fh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Fh 




GET INKEY Proactive 
command 

Text String TLV = 8D 81 
80 04 55 55... 


20 


Successful call, buffer length = 240 

Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length =240 




GET INKEY Proactive 
command 

Text String TLV = 
8D 81 Fl 04 55 55... 


21 


Call the initGetlnkeyO method with a too long 
buffer 

qualifier = 
dcs = 4 

buffer = "XXXX..." 
offset = 
length = 241 


HANDLER_OVERFLOW 
ToolkitException is thrown 




22 


Call the InitGetlnkeyO without sending the 
command 




No proactive command 
shall be sent expected 
status is '9000' 



6.2.7.4.4 



Test Coverage 



CRR number 


Test case number 


N1 


8,9, 10, 11, 12, 13, 14, 
15, 16, 18, 19,20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


21 
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6.2.7.5 Method initGetlnput 

Test Area Reference: API_2_PAH_INGPBB_BSSSS 

6.2.7.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initGetlnput (byte qualifier, 

byte dcs, 
byte [ ] buffer, 
short offset, 
short length, 
short minRespLength, 
short maxRespLength) 
throws Java . lang.NullPointerException, 

Java . lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 

Normal execution 

CRRNl: The method shall build a GET INPUT proactive command in the ProactiveHandler, using qualifier, dcs, 
buffer, minRespLength and maxRespLength parameters. Comprehension Required flags are set. 

CRRN2: A call to this method clears the handler then initialises it. 

CRRN3: No TLV is selected after a call to the method. 

CRRN4: The GET INPUT command is not sent by the method. 

CRRN5: The Command Number may take any value between Olh and FEh. 

Parameter errors 

CRRPl: The method shall throw NullPointerException if buffer is null. 

CRRP2: If offset or length or both would cause access outside array bounds, a ArraylndexOutOfBoundsException 
shall be thrown. 

Context errors 

CRRCl: A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is to small to put 
the requested data. 

6.2.7.5.2 Test Suite files 

Test Script: API_2_PAH_INGPBB_BSSSS_Lscr 

Test Applet: API_2_PAH_INGPBB_BSSSS_Ljava 

Load Script: API_2_PAH_INGPBB_BSSSS_Lldr 

Cleanup Script: API_2_PAH_INGPBB_BSSSS_Lclr 
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6.2.7.5.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

buffer = NULL 


NullPointerException is thrown 




2 


offset > buffer.length 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is tlirown 






offset = 5 






3 


Offset < 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is tlirown 






offset = -1 






4 


length > buffer.length 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = 








length = 5 






5 


Offset + length > buffer.length 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = 3 








length = 2 






6 


length < 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = 3 








length = -1 






7 


Successful call, buffer is the whole buffer 

qualifier = 

dcs = 4 

buffer = "TextA" 

offset = 

length = 5 

minRespLength = OOh 

maxRespLength = FFh 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and -FEh 




8 


Send the command 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextA" 
Min Length = OOh 
Max Length = FFh 


9 


Succesfull call, buffer is part of a buffer with 




GET INPUT Proactive 




the end part 




command 




Send the command 








qualifier = 




qualifier = OOh 




dcs = 4 




dcs = 4 




buffer = "12TextB" 




Text = "TextB" 




offset = 2 




Min Length = lOh 




length = 5 




Max Length = FFh 




minRespLength = lOh 








maxRespLength = FFh 






10 


Succesfull call, buffer is part of a buffer with 




GET INPUT Proactive 




the first part 




command 




Send the command 








qualifier = 




qualifier = OOh 




dcs = 4 




dcs = 4 




buffer = "TextC12" 




Text = "TextC" 




offset = 




Min Length = FFh 




length = 5 




Max Length = FFh 




minRespLength = FFh 








maxRespLength = FFh 






11 


Succesfull call, buffer is part of a buffer 




GET INPUT Proactive 




Send the command 




command 




qualifier = 








dcs = 4 




qualifier = OOh 




buffer = "12TextD34" 




dcs = 4 




offset = 2 




Text = "TextD" 




length = 5 




Min Length = OOh 




minRespLength = OOh 




Max Length = OOh 




maxRespLength = OOh 






12 


Succesfull call, qualifier = 81h 




GET INPUT Proactive 




qualifier = 81h 




command 




dcs = 4 
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buffer = "TextE" 
offset = 




qualifier = 81h 
dcs = 4 




length = 5 
minRespLength = OOh 
maxRespLength = lOh 




Text = "TextE" 
Min Length = OOh 
Max Length = lOh 


13 


Succesfull call, DCS=0 (7 bits) 

qualifier = 
dcs = 




GET INPUT Proactive 
command 




buffer = "TextF" 
offset = 
length = 5 
minRespLength = lOh 
maxRespLength = lOh 




qualifier = OOh 
dcs = 

Text = "TextF" 
Min Length = lOh 
Max Length = lOh 


14 


Succesfull call, DCS=8 (UCS2) 

qualifier = 
dcs = 8 




GET INPUT Proactive 
command 




buffer = "TextG" 
offset = 
length = 5 
minRespLength = OOh 
maxRespLength = FFh 




qualifier = OOh 
dcs = 8 

Text = "TextG" 
Min Length = OOh 
Max Length = FFh 


15 


Call the InitGetlnputO method with any value 
Then build and send a GET INPUT command 




GET INPUT Proactive 
command 




qualifier = 

dcs = 4 

buffer = "TextHTextH" 




qualifier = OOh 
dcs = 4 




offset = 
length = 10 
minRespLength = OOh 
maxRespLength = lOh 




Text = "TextHTextH" 
Min Length = OOh 
Max Length = lOh 


16 


Successful call, text length is null 
Send the command 




GET INPUT Proactive 
command 




qualifier = 
dcs = 4 
buffer = "" 
offset = 
length = 
minRespLength = OOh 
maxRespLength = lOh 




qualifier = OOh 

Text String TLV = 8D 00 

Min Length = OOh 

Max Length = lOh 


17 


Select a TLV in the ProactiveHandler 

Call the InitGetlnputO method 

Call the getValueLengthO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthO 




18 


Successful call, buffer length = 7Eh 

qualifier = 




GET INPUT Proactive 
command 




dcs = 4 

buffer = "UUU..." 

offset = 

length = 7Eh 

minRespLength = OOh 

maxRespLength = lOh 




Text String TLV = 
8D 7F 04 55 55... 
Min Length = OOh 
Max Length = lOh 


19 


Successful call, buffer length = 7Fh 

qualifier = 




GET INPUT Proactive 
command 




dcs = 4 

buffer = "UUU..." 

offset = 

length = 7Fh 

minRespLength = OOh 

maxRespLength = lOh 




Text String TLV = 8D 81 
80 04 55 55... 
Min Length = OOh 
Max Length = lOh 


20 


Successful call, buffer length = 236 

Qualifier = 




GET INPUT Proactive 
command 




dcs = 4 

buffer = "UUU..." 

offset = 

length = 236 

minRespLength = OOh 

maxRespLength = lOh 




Text String TLV = 
8D 81 ED 04 55 55... 


21 


Call the InitGetlnputO method with a too long 
buffer 


HANDLER_OVERFLOW 
ToolkitException is thrown 
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qualifier = 

dcs = 4 

buffer = "XXXX..." 

offset = 

length = 237 

minRespLength = OOh 

maxRespLength = lOh 






22 


Call the initGetlnputO without sending the 
command 




No proactive command 
shall be sent expected 
status is '9000' 



6.2.7.5.4 



Test Coverage 



CRR number 


Test case number 


N1 


8,9, 10, 11, 12, 13, 14, 
15, 16, 18, 19,20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


21 



6.2.7.6 Method send 

Test Area Reference: API_2_PAH_SEND 

6.2.7.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte sendO 

Normal execution 

CRRNl: The send() method send the current proactive command to the mobile. 

CRRN2: The returned byte is equal to general result of the command (first byte of Result TLV in Terminal 
Response). 

CRRN3: The handler remains unchanged after a call to send() method until the use of initXX() or appendTLV(). 

CRRN4: There is no invocation of select() or deselect() method. 

CRRN5: A pending toolkit applet transaction at the method invocation is aborted. 

Parameter errors 
No requirements 

Context errors 

CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown is the Result Simple TLV is missing in 
Terminal Response. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the general result byte is missing 
in the Result Simple TLV in Terminal Response. 



6.2.7.6.2 
Test Script: 
Test Applet: 



Test Suite files 

API_2_PAH_SEND_1 .scr 
API_2_PAH_SEND_1 .Java 
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Load Script: 
Cleanup Script: 

6.2.7.6.3 



API_2_PAH_SEND_1 .Idr 
API_2_PAH_SEND_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


2 


Terminal Response with General Result = 00 

Result TLV = 03 01 00 (command performed 
successfully) 


Result of sendQ is OOh 




3 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


4 


Terminal Response with General Result = 01 , 
without Additional information on result 

Result TLV = 03 01 01 (command performed 
with partial comprehension) 


Result of sendQ is 01 h 




5 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


6 


Terminal Response with General Result = 01 , 
with Additional information on result 

Result TLV = 03 02 01 55 (command 
performed with partial comprehension) 


Result of sendQ is 01 h 




7 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


8 


Terminal Response with General Result = 02 

Result TLV = 03 04 02 65 43 21 (Missing 
information) 


Result of sendQ is 02h 




9 


Build and send a 7Fh byte command 
(DISPLAY TEXT) 

qualifier = OOh 
dcs = 04h 
buffer = "UUUUU..." 
length = 73h 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 7F 

Text String TLV = 8D 74 

04 55 55 55... 


10 


Build and send a 80h byte command 
(DISPLAY TEXT) 

qualifier = OOh 
dcs = 04h 
buffer = "UUUUU..." 
length = 74h 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 81 80 
Text String TLV = 8D 75 

04 55 55 55... 


11 


Build and send a maximum length command 
(length of the handler should be 253) 

DISPLAY TEXT: 
Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 240 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 81 FD 
Text String TLV = 8D 81 
Fl 04 55 55... 


12 


Verify that the Proactive Handler is not 

modified after a send() 

Build a DISPLAY TEXT command 

Copy ProactiveHandler to source byte array 

Send command 

Copy ProactiveHandler to destination byte 
array 
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Compare source and destination 


Source and destination are 
identical 




13 


Build and send a DISPLAY TEXT command 

Verify there is no Invocation of select() or 

deselectO method. 




DISPLAY TEXT Proactive 
command 


14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 02 02 12 
2nd Result TLV = 03 03 03 34 56 


Result of sendQ is 02h 




15 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result Simple 
TLV 


ToolkitException.UNAVAILABLE 
_ELEMENT is thrown by sendQ 




16 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without general result 
byte in the Simple TLV 

Result TLV = 03 00 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown by 
sendQ 





6.2.7.6.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,3,5,7,9, 10, 11, 12, 
13, 14 


N2 


2,4,6,8, 14 


N3 


12 


N4 


13 


N5 


To be checl<ed in 

Frameworl< tests and 

insert here cross 

reference 


CI 


15 


C2 


16 



6.2.7.7 Method getLength 

Test Area Reference API_2_PAH_GLEN 

6.2.7.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

Normal execution 

CRRN 1 : returns the length in bytes of the TLV list. 

Parameter errors 
No requirements 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 
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6.2.7.7.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.7.7.3 



Test Suite files 

API_2_PAH_GLEN_1 .scr 
API_2_PAH_GLEN_1 .Java 
API_2_PAH_GLEN_1 .Idr 
API_2_PAH_GLEN_1 xlr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear the handler 

getLength () 


Result of getLengthO is 




2 


Call the initO method 

getLength () 


Result of getLengthO is 9 




3 


Call the InitDisplayTextO method, with buffer 
length = 240 

getLength () 


Result of getLengthO is 253 




4 


Build a 7Fh Proactive Handler 

getLength () 


Result of getLengthO is 7Fh 




5 


Build a 80h Proactive Handler 

getLength {) 


Result of getLengthO is 80h 





6.2.7.7.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5 


C1 


Does not apply for 
Proactive Handler 



6.2.7.8 Method copy 

Test Area Reference API 2 PAH COPY BSS 



6.2.7.8.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

CRRNl: copies the simple TLV list contained in the handler to the destination byte array. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null a NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, an 
ArraylndexOutOfBoundsException is thrown. 
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CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.7.8.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.7.8.3 



Test Suite files 

API_2_PAH_COPY_BSS_Lscr 
API_2_PAH_ COPY_BSS_Ljava 
API_2_PAH_ COPY_BSS_l.ldr 
API_2_PAH_ COPY_BSS_Lclr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


Call the initO method 








DstOffset > dstBuffer.length 

dstBuffer .length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


DstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the simple TLV list 

dstBuffer.length = 10 
dstOffset = 
dstLength = 10 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

dstBuffer.length = 9 
dstOffset = 
dstLength = 9 


Result of copyQ is 9 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 9 


Result of copyQ is 12 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 





£75/ 



3GPP TS 11.13 version 7.2.0 Release 1998 



145 



ETSI TS 101 955 V7.2.0 (2001-09) 



6.2.7.8.4 



Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


P1 


1 


P2 


2,3,4,5,6 


P3 


7 


C1 


Does not apply for 
ProactiveHandler 



6.2.7.9 Method findTLV 

Test Area Reference API_2_PAH_FINDBB 

6.2.7.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag is 
set. 

CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension Required 
flag is not set. 

CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

CRRN5: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.7.9.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PAH_FINDBB_1 .scr 
API_2_PAH_FINDBB_1 .Java 
API_2_PAH_FINDBB_1 .Idr 
API_2_PAH_FINDBB_1 .ck 
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6.2.7.9.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








Invalid input parameter 

Occurrence = 


ToolkitException.BAD INPUT P 
ARAMETER is thrown 




2 


Call the initO method 








Search 1st TLV 

Tag = Olh 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

Tag = 03h 
Occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




8 


Search a tag with wrong occurrence 

Tag = Olh 
Occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




10 


Append a TLV with tag=02h 








Search the TLV 

Tag = 02h 
Occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Append a TLV with tag=04h 








Search the TLV 

Tag = 04h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 





6.2.7.9.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2,4 


N3 


10, 11 


N4 


6,7,8,9 


N5 


12, 13 


PI 


1 


CI 


Does not apply for 
Proactive Handler 



6.2.7.10 Method getValueLength 

Test Area Reference API_2_PAH_GVLE 

6.2.7.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 
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Normal execution 

CRRNl: gets and returns the binary length of the value field for the last TLV element which has been found in the 
handler. 

Parameter errors 
No requirements 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.10.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.7.10.3 



Test Suite files 

API_2_PAH_GVLE_1 .scr 
API_2_PAH_GVLE_1 .Java 
API_2_PAH_GVLE_1 .Idr 
API_2_PAH_GVLE_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the initO method 








getValueLength ( ) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Call the appendTLVQ method 

tag = OD 
valueOffset = 
valueLength = 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is OOh 




3 


Call the InitDisplayTextQ method 

length = 1 (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 02h 




4 


Call the InitDisplayTextO method 
length = 7Eh (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 7Fh 




5 


Call the InitDisplayTextO method 

length = 7Fh (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 80h 




6 


Call the InitDisplayTextO method 

length = FOh (maximum text length) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is Flh 
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6.2.7.10.4 



Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


C1 


Does not apply for 
Proactive Handler 


C2 


1 



6.2.7.1 1 Method getValueByte 

Test Area Reference API_2_PAH_GVBYS 

6.2.7.1 1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 

Normal execution 

CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 byte). 

Parameter errors 

CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.11.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PAH_GVBYS_l.scr 
API_2_PAH_GVBYS_1 .Java 
API_2_PAH_GVB YS_1 .Idr 
API_2_PAH_GVB YS_1 .ck 
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6.2.7.11.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the InitQ method 

type = FFh 
qualifier = FEh 
destination = FDh 








getValueByte(O) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueByte(3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueByte(2) 


Result is FEh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte(O) 


Result is 81 h (Source) 




5 


initDisplayTextO 

buffer = 00 01 ... 7D 

length = 7Eh 

Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




6 


initDisplayTextO 

buffer = 00 01 ... 7D 7E 

length = 7Fh 

Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




7 


getValueByte(7F) 


Result is 7Eh 




8 


InitDisplayTextO 

buffer = 00 01 ... EF 

length = FOh 

Search TLV ODh (Text String TLV) 








getValueByte(FO) 


Result is EFh 





6.2.7.11.4 



Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for 
Proactive Handler 


C2 


1 



6.2.7.12 Method copyValue 

Test Area Reference API_2_PAH_CPYVS_BSS 

6.2.7.12.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue (short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java -lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 
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Normal execution 

CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.12.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.7.12.3 



Test Suite files 

API_2_PAH_CPYVS_BSS_1 .scr 
API_2_PAH_CPYVS_BSS_1 .Java 
API_2_PAH_CPYVS_BSS_1 .Idr 
API_2_PAH_CPYVS_BSS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 
Select a TLV 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextQ with length = 15 

Select Text String TLV 








dstOffset > dstBuffer.length 

dstBuffer . length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDisplayTextO with length = 5 

Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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dstBuffer. length = 15 
dstOffset = 
dstLength = 






8 


[Select Text String TLV] 

valueOffset < 
valueOffset = -1 
dstBuffer. length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

dstLength > Text String length 
valueOffset = 
dstBuffer. length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


[Select Text String TLV] 

valueOffset + dstLength > Text String 

length 

valueOffset = 2 

dstBuffer. length = 15 

dstOffset = 

dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialise the handler 








copyValueO 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




12 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 

Select Text String TLV 








Successful call 

valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of copyValueO is 17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

valueOffset = 2 
dstBuffer .length = 20 
dstOffset = 3 
dstLength = 12 


Result of copyValueO is 15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 





6.2.7.12.4 



Test Coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


CI 


Does not apply for 
Proactive Handler 


C2 


11 



6.2.7.13 Method com pare Value 

Test Area Reference API_2_PAH_CPRVS_BSS 
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6.2.7.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte[] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

Compares the last found TLV element with a buffer: 

CRRNl: returns if identical. 

CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 

CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.7.13.2 Test Suite files 

Test Script: API_2_PAH_CPRVS_BSS_l.scr 

Test Applet: API_2_PAH_CPRVS_BSS_l.java 

Load Script: API_2_PAH_CPRVS_BSS_l.ldr 

Cleanup Script: API_2_PAH_CPRVS_BSS_l.clr 
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6.2.7.13.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 
Select a TLV 








compareValueO with a null compareBuffer 


NullPointerException is thrown 




2 


InitDisplayTextQ with length = 15 

Select Text String TLV 








compareOffset > compareBuffer.length 

compareBuffer . length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDisplayTextO with length = 5 
Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

compareLength > Text String length 
valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


[Select Text String TLV] 

valueOffset + compareLength > Text String 

length 

valueOffset = 2 

compareBuffer.length = 15 

compareOffset = 

compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialise the handler 








compareValueQ 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 




12 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 

Select Text String TLV 








Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

valueOffset = 
compareOffset = 
compareLength = 17 


Result is OOh 




13 


Initialise compareBuffer 
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compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 
OE 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




15 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




16 


Initialise compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




18 


Initialise compareBuffer 

compareBuffer = 
55 55 55 99 03 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 





6.2.7.13.4 



Test Coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13, 16 


N3 


14, 17, 18 


PI 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


CI 


Does not apply for 
Proactive Handler 


C2 


11 



6.2.7.14 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) 

Test Area Reference API_2_PAH_FACYB_BS 

6.2.7.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag. 
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byte[] dstBuffer, 
short dstOffset) 
throws Java . lang . NullPointerException, 

Java .lang . Array IndexOutOfBoundsExcept ion, 
ToolkitException 



Normal execution 



CRRN 1 : looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into a 
destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.7.14.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.7.14.3 



Test Suite files 

API_2_PAH_FACYB_BS_1 .scr 
API_2_PAH_FACYB_BS_1 .Java 
API_2_PAH_FACYB_BS_1 .Idr 
API_2_PAH_FACYB_BS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








FindAndCopyVaiueQ with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextQ with length = 15 








dstOffset > dstBuffer.length 

tag = ODh 

dstBuffer.length = 20 
dstOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 20 

dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > dstBuffer.length 

dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


DstOffset + length >dstBuffer.length 

DstBuffer.length = 20 
DstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


InitDisplayTextO 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 03h 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 
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7 


initDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call 

Tag = ODh 

DstBuffer. length = 17 

DstOffset = 


Result of fincJAndcopyValueO is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOli 




9 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

dstBuffer. length = 20 
dstOffset = 2 


Result of findAndcopyValueO is 
19 




10 


Compare buffer 

buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




11 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








append a 2nd Text String TLV 








Successful call 

tag = ODh 

dstBuffer .length = 17 

dstOffset = 


Result of findAndcopyValueO is 
17 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




13 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 

dstBuffer. length = 17 

dstOffset = 


Result of findAndcopyValueO is 
17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




15 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag BFh) 

tag = 8Fh 

dstBuffer .length = 16 

dstOffset = 


Result of findAndcopyValueO is 
16 




16 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 





6.2.7.14.4 



Test Coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


PI 


1 


P2 


2, 3, 4, 5 


CI 


Does not apply for 
Proactive Handler 
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6.2.7.15 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 

Test Area Reference API_2_PAH_FACYBBS_BSS 

6.2.7.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.7.15.2 Test Suite files 

Test Script: API_2_PAH_FACYBBS_BSS_l.scr 

Test Applet: API_2_PAH_FACYBBS_BSS_l.java 

Load Script: API_2_PAH_FACYBBS_BSS_l.ldr 

Cleanup Script: API_2_PAH_FACYBBS_BSS_l.clr 
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6.2.7.15.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCopyVaiueQ with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextQ with length = 15 








dstOffset > dstBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDisplayTextO with length = 5 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


InitDisplayTextQ 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
_ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




12 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 17 
dstOffset = 
dstLength = 17 


Result of findAndCopyValueO is 
17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialise dstBuffer 
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dstBuffer = 55 55 ... 55 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 2 
dstBuffer .length = 20 
dstOffset = 3 
dstLength = 12 


Result of findAndcopyValueO is 
15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Append a Text String TLV 

tag = OD 

buffer = 00 11 22 33 44 55 (no specific 

DCS byte) 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer .length = 17 
dstOffset = 
dstLength =17 


Result of fincJAndCopyValueO is 
17 




17 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOli 




18 


Successful call 

tag = ODh, occurrence = 2 
valueOffset = 
dstBuffer .length = 6 
dstOffset = 
dstLength = 6 


Result of findAndCopyValueO is 
6 




19 


Compare buffer 

buffer = 00 11 22 33 44 55 


Result is OOh 




20 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call (with tag BDh) 

tag = BDh 
occurrence = 1 
valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of findAndcopyValueO is 
17 




21 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




22 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 
occurrence = 1 
valueOffset = 
dstBuffer .length = 16 
dstOffset = 
dstLength =16 


Result of findAndcopyValueO is 
16 




23 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 
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6.2.7.15.4 



Test Coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18 


N4 


20,21, 22,23 


P1 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


CI 


Does not apply for 
ProactiveHandler 



6.2.7.16 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 



Test Area Reference API 2 PAH FACRB BS 



6.2.7.16.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 

CRRN3: if identical returns 0. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 

CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1. 

CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.7.16.2 Test Suite files 

Test Script: API_2_PAH_FACRB_BS_l.scr 

Test Applet: API_2_PAH_FACRB_BS_Ljava 
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Load Script: 
Cleanup Script: 

6.2.7.16.3 



API_2_PAH_FACRB_BS_1 .Idr 
API_2_PAH_FACRB_BS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


initDisplayTextQ with length = 15 








compareOffset > compareBuffer.length 

tag = ODh 

compareBuffer.length = 20 
compareOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


length > compareBuffer.length 

compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 

compareBuf f er . length 
compareBuffer.length = 20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


InitDisplayTextO 








Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 03h 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




7 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialise compareBuffer 

compareBuf fer = 
04 00 01 ... OF 








Compare buffers 

tag = ODh 
compareOffset = 


Result is OOh 




8 


Verify current TLV 

getValueLength ( ) 


Result is 17 




9 


Initialise compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




10 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




11 


Initialise compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOffset = 2 


Result Is OOh 




12 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialise compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 
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Compare buffers 

compareOf f set = 2 


Result is OOh 




13 


Initialise compareBuffer 

compareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOf f set = 2 


Result is -1 




14 


Initialise compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

compareOf f set = 2 


Result is +1 




15 


initDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialise compareBuffer 

CompareBuffer = 04 00 01 ... OF 








Successful call (witli tag 8Dh) 

tag = 8Dh 

compareBuf fer . length = 17 

compareOf f set = 


Result is OOh 




16 


Append tag OFh 

buffer = 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag BFh) 

tag = 8Fh 

compareBuf fer . length =16 

compareOf f set = 


Result is OOh 




17 


Initialise compareBuffer 

compareBuffer = 00 99 01 03 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

compareBuf fer . length = 16 

compareOf f set = 


Result is +1 





6.2.7.16.4 



Test Coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12, 17 


N4 


9, 13 


N5 


10, 14 


N6 


15, 16 


PI 


1 


P2 


2, 3, 4, 5 


CI 


Does not apply for 
Proactive Handler 



6.2.7.17 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference API_2_PAH_FACRBBS_BSS 

6.2.7.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 
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public byte f indAndCompareValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws Java. lang.NullPointerException, 

Java . lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV Hst and compare its value with a 
buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 

CRRN3: if identical is returned. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 

CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 

CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

CRRP4: if an input parameter is not valid (e.g. occurence = 0) an instance of ToolkitException shall be thrown. The 
reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.7.17.2 Test Suite files 

Test Script: API_2_PAH_FACRBBS_BSS_l.scr 

Test Applet: API_2_PAH_FACRBBS_BSS_l.java 

Load Script: API_2_PAH_FACRBBS_BSS_l.ldr 

Cleanup Script: API_2_PAH_FACRBBS_BSS_l.clr 
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6.2.7.17.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 








findAndCompareVaiueQ with a null 
compareBuffer 


NullPointerException is thrown 




2 


InitDisplayTextQ with length = 15 








compareOffset > compareBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 

>compareBuf f er . length 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDisplayTextO with length = 5 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


ToolkitException.BAD_INPUT_P 
ARAIVIETER is thrown 




12 


InitDisplayTextQ 








Select a TLV (tag 02h) 








findAndCompareVaiueQ 

tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
_ELEIVIENT is thrown 






Call the getValueLengthQ method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




13 


InitDisplayTextQ 

dcs = 4 

buffer = 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareVaiueQ 


Result is OOh 
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tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 






14 


Verify current TLV 

getValueLength ( ) 


Result is 17 




15 


Initialise compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




16 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




17 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result Is OOh 




18 


Initialise compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




19 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




21 


Initialise compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




22 


Initialise compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 


Result is -1 
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compareLength = 6 






23 


initDisplayTextQ 

dcs = 4 

buffer = 00 01 ... OF 








Initialise compareBuffer 

CompareBuf fer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh, occurrence = 1 
valueOffset = 
compareBuf fer . length = 17 
compareOf f set = 
compareLength = 17 


Result is OOh 




24 


Append tag OFh 

buffer = 00 01 ... OF 








Initialise compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag BFh) 

tag = 8Fh, occurrence = 1 
valueOffset = 
compareBuf fer . length =16 
compareOf f set = 
compareLength = 16 


Result is OOh 




25 


Initialise compareBuffer 

compareBuffer =0099 02 ... OF 








findAndCompareValueO 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is +1 





6.2.7.17.4 



Test Coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17,20,21 


N4 


15, 18,22 


N5 


16, 19 


N6 


23,24 


P1 


1 


P2 


2, 3, 4, 5, 6 


PS 


7,8,9, 10 


P4 


11 


C1 


Does not apply for 
Proactive Handler 



6.2.7.18 Method appendArray 



Test Area Reference: API_2_PAH_APDA 

6.2.7.18.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendArray (byte [ ] buffer, 
short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 
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Normal execution 

CRRNl: appends a buffer into the Edithandler buffer 
CRRN2: a successful append does not modify the TLV selected 

Parameters error 

CRRPl: if buffer is null, a java.lang.NullPointerException is thrown 

CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE 



6.2.7.18.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.7.18.3 



Test suite files 

API_2_PAH_APDA_1 .scr 
API_2_PAH_APDA_1 .Java 
API_2_PAH_APDA_1 .Mr 
API_2_PAH_APDA_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null buffer 


NullPointerException is thrown 




2 


offset > buffer.length 

buf fer . length = 5 
offset = 6 
length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


Offset < 

buffer.length = 5 
offset = -1 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

buffer.length = 5 
offset = 
length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer.length = 5 
offset = 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

buffer.length = 256 
offset = 
length = 256 


ToolkitException. HANDLER OV 
ERFLOW is thrown 




8 


Initialise handler 








Select Command Details TLV 








Successful call 

buffer = FF FE ... F8 
offset = 
length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




9 


Clear the handler 








Successful call 
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buffer = FF FE ... F8 
offset = 
length = 8 








Call copyO method 








Compare the arrays 

compareBuf fer = FF FE ... F8 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




10 


Successful call 

buffer = 00 01 ... 07 
offset = 2 
length = 6 








Call copyO method 








Compare the arrays 

compareBuffer = FF FE ... F8 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCo 
mpareQ is OOh 




11 


Successful call 

buffer = 11 22 ... 88 
offset = 2 
length = 4 








Call copyO method 








Compare the arrays 

compareBuffer = FF FE ... F8 02 03 ... 07 33 

44 55 66 


Result of 

javacard.framework.Utll.arrayCo 
mpareO is OOh 




12 


Clear the handler 








Successful call 

buffer = 00 01 ... FC 
offset = 
length = 253 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 01 ... FC 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 





6.2.7.18.4 



Test Coverage 



CRR number 


Test case number 


N1 


9, 10, 11, 12 


N2 


8 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


7 


C2 


Does not apply for 
ProactiveHandler 



6.2.7.1 9 Method appendTLV(byte tag, byte value) 

Test Area Reference: API_2_PAH_APTLBB 

6.2.7.19.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, byte value) 
throws ToolkitException 

Normal execution 

CRRNl: Appends a TLV element to the current TLV list (1-byte element). 
CRRN2: A successful append does not modify the TLV selected. 
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Parameters error 
No requirements 

Context errors 

CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE 



6.2.7.19.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.7.19.3 



Test suite files 

API_2_PAH_APTLBB_Lscr 
API_2_PAH_APTLBB_Ljava 
API_2_PAH_APTLBB_1 .Idr 
API_2_PAH_APTLBB_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArrayO 

length = 251 








Handler Overflow: Call the appendTLVQ 
method 


ToolkitException. HANDLER OV 
ERFLOW is thrown 




2 


Initialise handler 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLengthQ 


Result is OSli 




3 


Clear the handler 








Successful call 

tag = 84h 
value = OOh 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 01 00 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




4 


Successful call 

tag = Olh 
value = FEh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 01 00 01 01 FE 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




5 


Clear the handler 








Call appendArrayO 

length = 250 

buffer = 00 81 F7 03 04 ... F9 








Successful call 

tag = 84h 
value = OOh 








Call getLengthO method 


result = 253 






Call copyO method 








Compare the array 

compareBuffer = 00 81 F7 03 04 ... F9 84 01 
00 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 
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6.2.7.19.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for 
Proactive Handler 



6.2.7.20 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: API_2_PAH_APTLBBB 

6.2.7.20.1 Conformance requirements: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte value) 
throws ToolkitException 

Normal execution 

CRRNl: Appends a TLV element to the current TLV list (2-byte element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 
No requirements 

Context errors 

CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 



6.2.7.20.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test suite files 

API_2_PAH_APTLBBB_l.scr 
API_2_PAH_APTLBBB_1 .Java 
API_2_PAH_APTLBBB_1 .Idr 
API_2_PAH_APTLBBB l.ch 
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6.2.7.20.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the InitDlsplayTextO 

length = 250 








Handler Overflow: Call the appendTLVQ 
method 


ToolkitException. HANDLER OV 
ERFLOW is thrown 




2 


Initialise handler 








Select Command Details TLV 








Call the appendTLVQ method 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




3 


Clear the handler 








Successful call 

tag = 84h 
valuel = OOh 
value2 = Olh 








Call copvO method 








Compare the arrays 

compareBuf fer = 84 02 00 01 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




4 


Successful call 

tag = Olh 
valuel = FEh 
value2 = FDh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 02 00 01 01 02 FE FD 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




5 


Clear the handler 








Call appendArrayO 

length = 249 

buffer = 00 81 F6 03 04 ... F8 








Successful call 

tag = 84h 
valuel = OOh 
value2 = Olh 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 81 F6 03 04 ... F8 84 02 
00 01 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 





6.2.7.20.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


CI 


1 


C2 


Does not apply for 
Proactive Handler 



6.2.7.21 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short valuelength) 

Test Area Reference: API_2_PAH_APTLB_BSS 

6.2.7.21.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag. 
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byte[] value, 
short valueoffset, 
short valuelength) 
throws Java . lang.NullPointerException, 

Java . lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 

Normal execution 

CRRNl: Appends a TLV element to the current TLV list (byte-array element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

CRRPl: if value is null, a Java. lang.NullPointerException is thrown 

CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is negative, a 
java.lang. ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER 



6.2.7.21.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.7.21.3 



Test suite files 

API_2_PAH_APTLB_BSS_l.scr 
API_2_PAH_APTLB_BSS_Ljava 
API_2_PAH_APTLB_BSS_Lldr 
API_2_PAH_APTLB_BSS_Lclr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value 


NullPointerException is thrown 




2 


valueOffset > value.length 

value. length = 5 
valueOffset = 6 
valuelength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


valueOffset < 

value.length = 5 
valueOffset = -1 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


valueLength > value.length 

value.length = 5 
valueOffset = 
valueLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


valueOffset + valueLength > value.length 

value . length = 5 
valueOffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

value.length = 5 
valueOffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value.length = 254 
valueOffset = 


ToolkitException. HANDLER OV 
ERFLOW is thrown 
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valueLength = 254 






8 


Bad parameter 

value. length = 256 
valueOffset = 
valueLength = 256 


ToolkitException.BAD INPUT P 
ARAMETER is thrown 




9 


Initialise handler 








Select Command Details TLV 








Successful call 

tag = 04 

value = FF FE ... F8 
valueOffset = 
valueLength = 8 








Verify Current TLV: Call getvaiueLength ( ) 


Result is 03h 




10 


Clear the handler 








Successful call 

tag = 04 

value = FF FE ... F8 
valueOffset = 
valueLength = 8 








Call copyO method 








Compare the arrays 

compareBuffer = 04 08 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




11 


Successful call 

tag = 85h 
value = 00 01 ... 07 
valueOffset = 2 
valueLength = 6 








Call copyO method 








Compare the arrays 

compareBuffer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




12 


Successful call 

tag = 01 

value = 11 22 ... 88 
valueOffset = 2 
valueLength = 4 








Call copyO method 








Compare the arrays 

compareBuffer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 01 04 33 44 55 66 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




13 


Clear the handler 








Successful call 

tag = 04 

value = 00 01 ... 7F 
valueOffset = 
valueLength = 80h 








Call copyO method 








Compare the arrays 

compareBuffer = 04 81 80 00 01. ..7F 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




14 


Clear the handler 








Successful call 

tag = 04 

value = 00 01 ... F9 
valueOffset = 
valueLength = 250 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 04 81 FA 00 01. ..F9 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 
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6.2.7.21.4 



Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


P1 


1 


P2 


2,3,4,5,6 


C1 


7 


C2 


Does not apply for 
Proactive Handler 


C3 


8 



6.2.7.22 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 
short value2length) 



Test Area Reference: API_2_PAH_APTLBB_BSS 



6.2.7.22.1 



Conformance requirement: 



The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte valuel 
byte [ ] value2, 
short value2of f set , 
short value21ength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

CRRNl: Appends a TLV element to the current TLV list (1 byte and a byte-array element). 
CRRN2: A successful append does not modify the TLV selected. 

Parameters error 

CRRPl: if value2 is null, a java.lang. NullPointerException is thrown 

CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, a java.lang. ArraylndexOutOfBoundsException is thrown. 

Context errors 

CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER 



6.2.7.22.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test suite files 

API_2_PAH_APTLBB_BSS_Lscr 
API_2_PAH_APTLBB_BSS_1 .Java 
API_2_PAH_APTLBB_BSS_1 .Idr 
API_2_PAH_APTLBB_BSS_1 .clr 
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6.2.7.22.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value2 


NullPointerException is thrown 




2 


value20ffset > value2.length 

value2 . length = 5 
value20ffset = 6 
value2Length = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


value20ffset < 

value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


value2Length > value2.length 

value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


value20ffset + value2Length > value2.length 

value2 . length = 5 
value20ffset = 3 
value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


value2Length < 

value2 . length = 5 
value20ffset = 
value2Length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value2 . length = 254 
value20ffset = 
value2Length = 254 


ToolkitException. HANDLER OV 
ERFLOW is thrown 




8 


Bad parameter 

value2 . length = 256 
value20ffset = 
value2Length = 256 


ToolkitException. BAD INPUT P 
ARAMETER is thrown 




9 


Initialise handler 








Select Command Details TLV 








Successful call 

tag = 04 
valuel = 05 
value2 = FF FE ... F8 
value20ffset = 
value2Length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




10 


Clear the handler 








Successful call 

tag = 04 
valuel = 05 
value2 = FF FE ... F8 
value20ffset = 
value2Length = 8 








Call copyO method 








Compare the arrays 

CompareBuffer = 04 09 05 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




11 


Successful call 

tag = 85h 
valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 








Call copyO method 








Compare the arrays 

CompareBuffer = 

04 09 05 FF FE ... F8 

85 07 55 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




12 


Successful call 

tag = 01 
valuel = 44h 
value2 = 11 22 ... 88 
value20ffset = 2 
value2Length = 4 








Call copyO method 








Compare the arrays 

CompareBuffer = 

04 09 05 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 
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85 07 55 02 03 ... 07 
01 05 44 33 44 55 66 






13 


Clear the handler 








Successful call 

tag = 04 
valuel = 00 
value2 = 01 ... 7F 
value20ffset = 
value2Length = 7Fh 








Call copyO method 








Compare the arrays 

compareBuffer = 04 81 80 00 01. ..7F 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOh 




14 


Clear the handler 








Successful call 

tag = 04 
valuel = 00 
value2 = 01 ... F9 
value20ffset = 
value2Length = 249 








Call getLengthO method 


result = 253 






Call copvO method 








Compare handler 

compareBuffer = 04 81 FA 00 01. ..F9 


Result of 

javacard.framework.Util.arrayCo 
mpareO is OOfi 





6.2.7.22.4 



Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for 
Proactive Handler 


C3 


8 



6.2.7.23 Method clear 

Test Area Reference: AP1_2_PAH_CLER 

6.2.7.23.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void clear ( ) 

throws ToolkitException EditHandler 

Normal execution 

CRRNl: Clears the TLV list of an EditHandler 
CRRN2: Resets the current TLV selected. 

Parameters error 
No requirements 
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CRRCl: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 



6.2.7.23.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.7.23.3 



Test suite files 

API_2_PAH_CLER_1 .scr 
API_2_PAH_CLER_1 .Java 
API_2_PAH_CLER_1 .Idr 
API_2_PAH_CLER_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialise the handler 

Select Command Details TLV 
Call the getLengthO method 


Result of getLengthO is not null 






Clear the handler 

Call the getLengthQ method 


Result of getLengthO is 




2 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 





6.2.7.23.4 



Test Coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 


C1 


Does not apply for 
Proactive Handler 



6.2.8 Class ProactiveResponseHandler 
6.2.8.1 Method copyAdditionallnformation 

Test Area Reference: API_2_PRH_CPAI_BSS 

6.2.8.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copyAdditionallnformation (byte [ ] dstBuffer^ 

short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException^ 
ToolkitException 

Normal execution 

CRRNl: The copyAdditionalInformation() method shall copy a part of the additional information field from Result 
TLV element in dstBuffer, using dstOffset and dstLength. 

CRRN2: dstBuffer shall only be modified from dstOffset to (dstOffset + dstLength - 1) (included). 

CRRN3: The method returns (dstOffset + dstLength). 
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CRRN4: If a Result TLV element is available, it becomes the TLV selected after a call to the method. 
CRRN5: The method shall copy from the first Result TLV. 

Parameter errors 

CRRPl: A NullPointerException shall be thrown if dstBuffer is null. 

CRRP2: An ArraylndexOutOfBoundsException shall be thrown if dstOffset or dstLength or both would cause 
access outside array bounds. 

Context errors 

CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if dstLength is greater than the value 
field of the available TLV. 



6.2.8.1.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.1.3 



Test Suite files 

API_2_PRH_CPAI_BSS_Lscr 
API_2_PRH_CPAI_BSS _Ljava 
API_2_PRH_CPAI_BSS _Lldr 
API_2_PRH_CPAI_BSS _Lclr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = 

dcs = 4 

buffer = "Text" 




DISPLAY TEXT Proactive 
command 




Terminal Response with 11 additional bytes 

Result TLV = 03 OC 01 01 23 45 67 89 AB 
CD EF 01 23 45 








NULL as parameter to dstBuffer 

dstBuffer = NULL 


NullPointerException is tlirown 




2 


dstOffset > dstBuffer.length 

dstBuffer. length = 10 
dstOffset = 11 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

dstBuffer.length = 10 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 10 
dstOffset = 
dstLength = 11 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 10 
dstOffset = 6 
dstLength = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 10 
dstOffset = 6 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 

Result TLV = 03 06 01 01 23 45 67 89 
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Successfull call, dstBuffer is the whole buffer 

dstBuffer. length = 5 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 




8 


Compare dstBuffer using arrayCompareQ 

src = {01, 23, 45, 67, 89} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 




9 


Call the getValueLengthO method 


Result is 06h. 




10 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 6 additional bytes 

Result TLV = 03 07 01 AB CD EF FE DC BA 








Successfull call, dstBuffer is part of a buffer 

dstBuffer .length = 7 
dstOffset = 2 
dstLength = 5 


result of 

copyAdditionallnformationO is 
07h. 




11 


Compare dstBuffer using arrayCompare() 

src = {AB, CD, EF, FE, DC} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 2 
length = 5 


result of arrayCompareO is OOh. 




12 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 7 additional bytes 

Result TLV = 03 08 01 FE DC BA 98 76 54 
32 








Successfull call, dstBuffer is part of a buffer 

dstBuffer. length = 7 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 




13 


Compare dstBuffer using arrayCompare() 

src = {FE, DC, BA, 98, 76} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 




14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 8 additional bytes 

Result TLV = 03 09 01 00 11 22 33 44 55 
66 77 








Successfull call, dstBuffer is the whole buffer 

dstBuffer .length = 9 
dstOffset = 2 
dstLength = 5 


result of 

copyAdditionallnformationO is 
07h. 




15 


Compare dstBuffer using arrayCompare() 

src = {00, 11, 22, 33, 44} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 2 
length = 5 


result of arrayCompareO is OOh. 




16 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with F2h additional bytes 

Result TLV = 03 81 F3 01 00 01 02 03... 








Successfull call to the method 

dstBuffer .length = F2h 
dstOffset = 
dstLength = F2h 


result of 

copyAdditionallnformationO is 
F2h. 




17 


Compare dstBuffer using arrayCompare() 


result of arrayCompareO is OOh. 





£75/ 



3GPP TS 11.13 version 7.2.0 Release 1998 



180 



ETSI TS 101 955 V7.2.0 (2001-09) 





src = {00, 01, 02, 03, 04...} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = F2h 






18 


Call the getValueLengthO method 


Result is F3h. 




19 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 

Result TLV = 03 06 01 00 11 22 33 44 








dstLength > data available 

dstBuffer . length = 6 
dstOffset = 
dstLength = 6 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 




20 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 

Result TLV = 03 06 01 00 11 22 33 44 








Initialise dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h...} 








Call the copyAdditionallnformationQ method 

dstBuffer. length = 20 
dstOffset = 5 
dstLength = 5 








Compare dstBuffer using arrayCompareQ 

src = { 

OOh, Olh, 02h, 03h, Olh, 
OOh, llh, 22h, 33h, 44h, 
OAh, OBh, OCh, ODh, OEh, 
OFh, lOh, llh, 12h, 13h} 
srcOffset = 
dest = dstBuffer 
destOffset = 
length = 20 


result of arrayCompareO is OOh 




21 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 
elements 

1st Result TLV = 03 06 01 01 23 45 67 89 
2nd Result TLV = 03 01 00 








Successfull call to 
copyAdditionallnformationO 

dstBuffer .length = 5 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 




22 


Compare dstBuffer using arrayCompareQ 

src = {01, 23, 45, 67, 89} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 




23 


Call the getValueLengthO method 


Result is 06h. 




24 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result Simple 
TLV 


ToolkitException.UNAVAILABLE 
_ELEIVIENT is thrown by send() 






ProactiveResponseHandler, getTheHandler 
call copyAdditionallnformationO 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 
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6.2.8.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


8, 11, 13, 15, 17,20,22 


N2 


20 


N3 


7, 10, 12, 14, 16,21 


N4 


9, 18,23 


N5 


21,22,23 


P1 


1 


P2 


2,3,4,5,6 


C1 


24 


C2 


19 



6.2.8.2 Method copyTextString 

Test Area Reference: API_2_PRH_CPTS_BS 



6.2.8.2.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short copyTextString (byte [ ] dstBuffer, 

short dstOffset) 
throws Java . lang . NullPointerException, 

Java. lang. Array I ndexOutOfBoundsExcept ion, 
ToolkitException 

Normal execution 

CRRNl: The copyTextStringO method copies the text string value from the first Text String TLV element, using 
dstBuffer and dstOffset. 

CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

CRRN3: The method returns (dstOffset + length of copied value). 

Parameter errors 

CRRPl: A NullPointerException shall be thrown if dstBuffer is null. 

CRRP2: A ArraylndexOutOfBoundsException shall be thrown if dstOffset or dstOffset + (length of the TextString 
to be copied, without the Data Coding Scheme included), as specified for the returned value, would cause access 
outside array bounds. 

Context errors 

CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String TLV 
element. 



6.2.8.2.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PRH_CPTS_BS_1 .scr 
API_2_PRH_CPTS_BS_1 .Java 
API_2_PRH_CPTS_BS_1 .Idr 
API_2_PRH_CPTS_BS_1 .clr 
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6.2.8.2.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a GET INPUT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 
minRespLength = OOh 
maxRespLength = FFh 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 02 04 41 








ProactiveResponseHandler.getTheHandlerO ; 

call the copyTextStringO method with a null 
cIstBuffer 

dstBuffer = null 
dstOffset = 


NullPointerExceptlon is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response 

Text String TLV = OD 04 04 "ABC" 








dstOffset + text length > dstBuffer.length 

dstBuffer. length = 04h 
dstOffset = 02h 


Array IndexOutOfBoundsException 
is thrown 




3 


dstOffset < 

dstBuffer.length = 04h 
dstOffset = -1 


ArraylndexOutOfBoundsException 
is thrown 




4 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT 
Proactive command 




Terminal Response without Text String TLV 








ProactiveResponseHandler.getTheHandlerO ; 

call the CopyTextStringO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




5 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response with a null Text String tlv 

Text String TLV = OD 00 








Initialise dstBuffer 

dstBuffer = {FOOh, FOlh, F02h, F03h} 








Call the copyTextStringO method 

dstBuffer.length = 04h 
dstOffset = 02h 


Result of copyTextStringO is 02h 




6 


Compare dstBuffer using arrayCompare() 

src = {OFOh, OFlh, 0F2h, 0F3h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




7 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response with text length = Olh 

Text String TLV = OD 02 04 41 








Initialise dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStringO method 

dstBuffer.length = 04h 
dstOffset = OOh 


Result of copyTextStringO is 01 h 
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8 


Compare dstBuffer using arrayCompare() 

src = {41h, Olh, 02h, 03h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




9 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response with text length = 02h 

Text String TLV = OD 03 04 42 43 








Initialise dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStringO method 

dstBuffer. length = 04h 
dstOffset = 02h 


Result of copyTextStringO is 04h 




10 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh, 42h, 43h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = Olh 


Result of arrayCompareO is OOh 




11 


Call the getValueLengthO method 


Result is 03h 




12 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








Initialise dstBuffer 

dstBuffer = {OOh, OOh ... OOh} 








Call the copyTextStringO method 

dstBuffer .length = 7Eh 
dstOffset = OOh 


Result of copyTextStringO is 7Eh 




13 


Compare dstBuffer using arrayCompare() 

src = {Olh, ..., 7Eh} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 7Eh 


Result of arrayCompareO is OOh 




14 


Call the getValueLengthO method 


Result is 7Fh 




15 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh 

Text String TLV = OD 81 80 04 01 02 ...7F 








Initialise dstBuffer 

dstBuffer = {OOh, Olh ... FFh} 








Call the copyTextStringO method 

dstBuffer .length = FFh 
dstOffset = lOh 


Result of copyTextStringO is 8Fh 




16 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh,... OFh, 
Olh, ...7Fh, 8Fh, ... FFh} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = FFh 


Result of arrayCompareO is OOh 




17 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... EF 








Initialise dstBuffer 
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dstBuffer = {OOh, OOh ... OOh} 








Call the copyTextStringO method 

dstBuffer .length = FFh 
dstOffset = OOh 


Result of copyTextStringO is EFh 




18 


Compare dstBuffer using arrayCompare() 

src = {Olh, ...EFh, OOh ... OOh } 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = FFh 


Result of arrayCompareO is OOh 




19 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with two Text String TLV 

1st Text String TLV = OD 03 04 42 43 
2nd Text String TLV = OD 02 04 44 








Initialise dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStringO method 

dstBuffer .length = 04h 
dstOffset = 02h 


Result of copyTextStringO is 04h 




20 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh, 42h, 43h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




21 


Call the getValueLengthO method 


Result is 03h 





6.2.8.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


6,8, 10, 13, 16, 18,20 


N2 


11, 14,21 


N3 


5,7,9, 12, 15, 17, 19 


PI 


1 


P2 


2,3 


CI 


4 



6.2.8.3 Method getAdditionallnformationLength 

Test Area Reference: API_2_PRH_GTIL 

6.2.8.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getAdditionallnformationLength ( ) 
throws ToolkitException 

Normal execution 

CRRNl: This method returns the length of the additional information field from the first Result TLV in the 
ProactiveResponseHandler. 

CRRN2: After a successful execution of the method, the Result TLV becomes the selected TLV of the 
ProactiveResponseHandler. 

Parameter errors 
No requirements 



£75/ 



3GPP TS 1 1 .1 3 version 7.2.0 Release 1 998 



185 



ETSI TS 101 955 V7.2.0 (2001-09) 



Context errors 

CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 



6.2.8.3.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.3.3 



Test Suite files 

API_2_PRH_GTIL_1 .scr 
API_2_PRH_GTIL_1 .Java 
API_2_PRH_GTIL_1 .Idr 
API_2_PRH_GTIL_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 




Terminal Response without additional 
information 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAdditionallnformationLengthQ 

method 


Result is OOh 




2 


Call the getValueLengthO method 


Result is 01 h 




3 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 

ProactiveProactive 

command 




Terminal Response with 1 additional byte 

Result TLV = 03 02 02 55 








ProactiveResponseHandler.getTheHandlerQ ; 

call the getAdditionallnformationLengthQ 

method 


Result is Olh 




4 


Call the getValueLengthO method 


Result is 02h 




5 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 

ProactiveProactive 

command 




Terminal Response with 7Eh additional bytes 

Result TLV = 03 7F 02 55 55 55 ... 








ProactlveResponseHandler.getTheHandlerQ ; 

call the getAdditionallnformationLengthQ 

method 


Result is 7Eh 




6 


Call the getValueLengthO method 


Result is 7Fh 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 7Fh additional bytes 

Result TLV = 03 81 80 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAdditionallnformationLengthO 

method 


Result is 7Fh 




8 


Call the getValueLengthO method 


Result is BOh 




9 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 80h additional bytes 
Result TLV = 03 81 81 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerO ; 


Result is 80h 
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call the getAdditionallnformatlonLengthO 
method 






10 


Call the getValueLengthO method 


Result is 81 h 




11 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with F2h additional bytes 

Result TLV = 03 81 F3 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerQ ; 

call the getAdditionallnformationLengthQ 

method 


Result is F2li 




12 


Call the getValueLengthO method 


Result is F3h 




13 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 03 02 01 23 
2nd Result TLV = 03 01 00 








ProactiveResponseHandler.getTheHandlerQ ; 

call the getAdditionallnformationLengthQ 

method 


Result is 02h 




14 


Call the getValueLengthO method 


Result is 03h 




15 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response without Result Simple 
TLV 


ToolkitException.UNAVAILABLE_E 
LEMENT is thrown by send() 






Get ProactiveResponseHandler 








Call the getAdditionallnformationLengthO 
method 


ToolkitException.UNAVAILABLE_E 
LEMENT is thrown by 
getAdditionallnformationLength Q 





6.2.8.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,3,5,7,9, 11, 13 


N2 


2,4,6, 8, 10, 12, 14 


CI 


15 



6.2.8.4 Method getGeneralResult 

Test Area Reference: API_2_PRH_GTGR 

6.2.8.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getGeneralResult ( ) 

throws ToolkitException 

Normal execution 

CRRNl: This method returns the general result of a proactive command. 

CRRN2: After a successful execution of the method, the Result TLV becomes the selected TLV of the 
ProactiveResponseHandler. 

Parameter errors 
No requirements 
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Context errors 

CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the general result byte is missing 
in the Result Simple TLV. 



6.2.8.4.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.4.3 



Test Suite files 

API_2_PRH_GTGR_1 .scr 
API_2_PRH_GTGR_1 .Java 
API_2_PRH_GTGR_1 .Idr 
API_2_PRH_GTGR_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 00 
(command performed successfully) 








ProactiveResponseHandler.getTheHandlerQ 
Call the getGeneralResultO method 


Result of getGeneralResultO is OOh 




2 


Call the getValueLengthO method 


Result is 01 h 




3 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 01, 

without Additional information on result 

(command performed with partial 

comprehension) 








ProactiveResponseHandler.getTheHandlerQ 
Call the getGeneralResultO method 


Result of getGeneralResultO is 01 h 




4 


Call the getValueLengthO method 


Result is 01 h 




5 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 01, 
with Additional information on result 

Result TLV = 03 02 01 55 (command 
performed with partial comprehension) 








ProactiveResponseHandler.getTheHandlerO 

Call the getGeneralResultO method 


Result of getGeneralResultO is 01 h 




6 


Call the getValueLengthO method 


Result is 02h 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 02 

Result TLV = 03 04 02 65 43 21 (Missing 
information) 








ProactiveResponseHandler.getTheHandlerO 

Call the getGeneralResultO method 


Result of getGeneralResultO is 02h 




8 


Call the getValueLengthO method 


Result is 04h 




9 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 



£75/ 



3GPP TS 11.13 version 7.2.0 Release 1998 



188 



ETSI TS 101 955 V7.2.0 (2001-09) 









command 




Terminal Response with 7Fh additional bytes 

Result TLV = 03 81 80 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerQ ; 
call the getGeneralResultO method 


Result is 02h 




10 


Call the getValueLengthO method 


Result is 80h 




11 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 02 02 12 
2nd Result TLV = 03 03 03 34 56 








ProactiveResponseHandler.getTheHandlerO ; 

call the getGeneralResultO method 


Result is 02h 




12 


Call the getValueLengthO method 


Result is 02h 




13 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result Simple 
TLV 


ToolkitException.UNAVAILABLE_E 
LEMENT is thrown by send() 






ProactiveResponseHandler.getTheHandlerO ; 
call the getGeneralResultO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without General Result 
Byte in Result Simple TLV 


ToolkitException.UNAVAILABLE_E 
LEMENT is thrown by send() 






ProactiveResponseHandler.getTheHandlerO ; 

call the getGeneralResultO method 
Result TLV = 03 00 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 





6.2.8.4.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,3, 5, 7, 9, 11 


N2 


2,4,6,8, 10, 12 


CI 


13 


C2 


14 



6.2.8.5 Method getltem Identifier 

Test Area Reference: API_2_PRH_GTII 

6.2.8.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getltemldentif ier ( ) 

throws ToolkitException 

Normal execution 

CRRNl: The method returns the item identifier byte value from the first Item Identifier TLV element. 
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CRRN2: If an Item Identifier TLV element is available, it becomes the TLV selected. 

Parameter errors 
No requirements 

Context errors 

CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Item Identifier 
TLV element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the item identifier byte is missing 
in the Item Identifier Simple TLV. 



6.2.8.5.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.5.3 



Test Suite files 

API_2_PRH_GTII_1 .scr 
API_2_PRH_GTII_1 .Java 
API_2_PRH_GTII_1 .Idr 
API_2_PRH_GTII_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response (no Item Identifier TLV 
available) 








Call to getltemldentifierO with unavailable 
Item Identifier TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a SELECT ITEM command 
with2items(ID=01,02) 




SELECT ITEM Proactive 
command 




Terminal Response with Item 1 selected 

Item Identifier TLV = 10 01 01 








Call the getltemldentifierO method 


Result is Olli 




3 


Call the getValueByteO method 

valueOffset = OOh 


Result is 01 h 




4 


Build and send a SELECT ITEM command 
with 3 items (ID=03, 05, 07) 




SELECT ITEM Proactive 
command 




Terminal Response with Item 5 selected 

Item Identifier TLV = 10 01 05 








Call the getltemldentifierO method 


Result is 05h 




5 


Call the getValueByteO method 

valueOffset = OOh 


Result is 05h 




6 


Build and send a SELECT ITEM command 
with 3 items (ID=FDh, FEh, FFh) 




SELECT ITEM Proactive 
command 




Terminal Response with Item FFh selected 

Item Identifier TLV = 10 01 FF 








Call the getltemldentifierO method 


Result is FFh 




7 


Call the getValueByteO method 

valueOffset = OOh 


Result is FFh 




8 


Build and send a SELECT ITEM command 
with 3 items (ID=FDh, FEh, FFh) 




SELECT ITEM Proactive 
command 
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Terminal Response with 2 Item Identifier tlv 

1st Item Identifier TLV = 10 01 FFh 
2nd Item Identifier TLV = 10 01 FEh 








Call the getltemldentifierO method 


Result is FFh 




9 


Call the getValueByteO method 

valueOffset = OOh 


Result is FFh 




10 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without item identifier in 
the Item Identifier Simple TLV 

Item Identifier TLV = 10 00 








Call to getltemldentifierO 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 





6.2.8.5.4 



Test Coverage 



CRR number 


Test case number 


N1 


2, 4, 6, 8 


N2 


3, 5, 7, 9 


C1 


1 


C2 


10 



6.2.8.6 Method getTextStringCodingScheme 

Test Area Reference: API_2_PRH_GTCS 

6.2.8.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getTextStringCodingScheme ( ) 

throws ToolkitException 

Normal execution 

CRRNl: This method returns the data coding scheme from the first Text String TLV element. 
CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

Parameter errors 
No requirements 

Context errors 

CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String TLV 
element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the Text String TLV is present 
with a length of 0. 



6.2.8.6.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PRH_GTCS_1 .scr 
API_2_PRH_GTCS_1 .Java 
API_2_PRH_GTCS_1 .Idr 
API_2_PRH_GTCS_1 .clr 
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6.2.8.6.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response (no Text String TLV 
element available) 








Call to getTextStringCodingSchemeO with 
unavailable Text String TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with a null Text String TLV 

Text String TLV = OD 00 








Call the getTextStringCodingSchemeO 
method 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 




3 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 01 h, dcs 

= 04h 

Text String TLV = OD 02 04 "A" 








Call the getTextStringCodingSchemeO method 


Result is 04h 




4 


Call the getValueLengthO method 


Result is 02h 




5 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 02h, 
DCS = OOh 

Text String TLV = OD 03 00 "BB" 








Call the getTextStringCodingSchemeO 
method 


Result is OOh 




6 


Call the getValueLengthO method 


Result is 03h 




7 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh, 
DCS = 08h 

Text String TLV = OD 7F 08 01 02 ... 7E 








Call the getTextStringCodingSchemeO 
method 


Result is 08h 




8 


Call the getValueLengthO method 


Result is 7Fh 




9 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh, 
DCS = 04h 

Text String TLV = OD 81 80 04 01 02 ... 7F 








Call the getTextStringCodingSchemeO 
method 


Result is 04h 




10 


Call the getValueLengthO method 


Result is BOh 
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11 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh, 
DCS = 08h 

Text String TLV = OD 81 FO 08 01 02 ... EE 
EF 








Call the getTextStringCodingSchemeQ 
method 


Result is 08h 




12 


Call the getValueLengthO method 


Result is FOh 




13 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with 2 Text String TLV 

1st Text String TLV = OD 02 04 41 
2nd Text String TLV = OD 03 08 42 43 








Call the getTextStringCodingSchemeQ 
method 


Result is 04li 




14 


Call the getValueLengthO method 


Result is 02h 





6.2.8.6.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,5,7, 9,11,13 


N2 


4,6,8, 10, 12, 14 


CI 


1 


C2 


2 



6.2.8.7 Method GetTextStringLength 

Test Area Reference: API_2_PRH_GTTL 

6.2.8.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getTextStringLength ( ) 

throws ToolkitException 

Normal execution 

CRRNl: The getTextStringLength() method returns the text string length value from the first Text String TLV 
element. 

CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

Parameter errors 
No requirements 

Context errors 

CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String TLV 
element. 
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6.2.8.7.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.7.3 



Test Suite files 

API_2_PRH_GTTL_1 .scr 
API_2_PRH_GTTL_1 .Java 
API_2_PRH_GTTL_1 .Mr 
API_2_PRH_GTTL_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response (no Text String TLV 
element available) 








Call to getTextStringLengthQ with unavailable 
Text String TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with a null Text String TLV 

Text String TLV = OD 00 








Call the getTextStringLengthO method 


Result is OOh 




3 


Call the getValueLengthO method 


Result is OOh 




4 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 01 h, 
DCS = 04h 

Text String TLV = OD 02 04 "A" 








Call the getTextStringLengthO method 


Result is 01 h 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 02h, 
DCS = OOh 

Text String TLV = OD 03 00 "BB" 








Call the getTextStringLengthO method 


Result is 02h 




7 


Call the getValueLengthO method 


Result is 03h 




8 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh, 
DCS = 08h 

Text String TLV = OD 7F 08 01 02 ... 7E 








Call the getTextStringLengthO method 


Result is 7Eh 




9 


Call the getValueLengthO method 


Result is 7Fh 




10 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh, 
DCS = 04h 

Text String TLV = OD 81 80 04 01 02 ... 7F 








Call the getTextStringLengthO method 


Result is 7Fh 
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11 


Call the getValueLengthO method 


Result is 80h 




12 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh, 
DCS = 04h 

Text String TLV = OD 81 FO 04 01 02 ... EE 
EF 








Call the getTextStringLengthO method 


Result is EFh 




13 


Call the getValueLengthO method 


Result is FOh 




14 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with 2 Text String TLV 

1st Text String TLV = OD 02 04 41 
2ncl Text String TLV = OD 03 08 42 43 








Call the getTextStringLengthO method 


Result is Olh 




15 


Call the getValueLengthO method 


Result is 02h 





6.2.8.7.4 



Test Coverage 



CRR number 


Test case number 


1 


2,4,6, 8, 10, 12, 14 


2 


3,5,7, 9, 11, 13, 15 


3 


1 



6.2.8.8 Method getTheHandler 

Test Area Reference: API_2_PRH_GTHD 

6.2.8.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ProactiveResponseHandler getTheHandler ( ) 

throws ToolkitException 

Normal execution 

CRRNl: The method shall return the single system instance of the ProactiveHandler class. 
CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object 

Parameter errors 
No requirements 

Context errors 

CRRCl: The method shall throw ToolkitException.HANDLER_NOT_AVAILABLE if the handler is busy. 



6.2.8.8.2 
Test Script: 
Test Applet: 



Test Suite files 

API_2_PRH_GTHD_l.scr 
API_2_PRH_GTHD_1 .Java 
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Load Script: 
Cleanup Script: 

6.2.8.8.3 



6.2.8.8.4 



API_2_PRH_GTHD_1 .Idr 
API_2_PRH_GTHD_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a Proactive Command 




Proactive Command 




Terminal Response 








getTheHandlerO twice 


The returned objects shall be the 
same 




2 


getTheHandlerO 


The reference shall be a 
ProactiveResponseHandler 




3 


getTheHandlerO 


The reference shall not be null 





Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


To be checked in 

Framework tests and 

insert here cross 

reference 


C1 


To be checked in 

Framework tests and 

insert here cross 

reference 



6.2.8.9 Method getLength 

Test Area Reference API_2_PRH_GLEN 

6.2.8.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

Normal execution 

CRRNl : returns the length in bytes of the TLV list. 

Parameter errors 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



6.2.8.9.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PRH_GLEN_1 .scr 
API_2_PRH_GLEN_1 .Java 
API_2_PRH_GLEN_1 .Idr 
API 2 PRH GLEN l.clr 
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6.2.8.9.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a Display Text command 




DISPLAY TEXT Proactive 
command 




Terminal Response without additional 
information in General Result TLV 








ProactiveResponseHandler.getTheHandlerQ 

getLength () 


Result of getLengthO is 12 




2 


Build and send a Display Text command 




DISPLAY TEXT Proactive 
command 




Terminal Response with F2h additional 
information in General Result TLV 








ProactiveResponseHandler.getTheHandlerQ 
getLengthO 


Result of getLengthO is FFh 





6.2.8.9.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2 


C1 


Does not apply for 

Proactive Response 

Handler 



6.2.8.10 Method copy 

Test Area Reference API 2 PRH COPY BSS 



6.2.8.10.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

CRRNl: copies the simple TLV list contained in the handler to the destination byte array. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null a NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, an 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.8.10.2 Test Suite files 

Test Script: API_2_PRH_COPY_BSS_l.scr 
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Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.10.3 



API_2_PRH_COPY_BSS_l .Java 
API_2_PRH_COPY_BSS_l .Idr 
API_2_PRH_COPY_BSS_l .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Additional 
Information in General Result TLV: 

81 03 01 21 00 02 02 82 81 03 01 00 








ProactiveResponseHandler.getTheHandlerQ 
copyO with NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

dstBuffer .length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the simple TLV list 

dstBuffer.length = 13 
dstOffset = 
dstLength = 13 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

dstBuffer.length = 12 
dstOffset = 
dstLength = 12 


Result of copyQ is 12 




9 


Compare the buffer with buffer: 

81 03 01 21 00 02 02 82 81 03 01 00 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 20 
dstOffset = 3 
dstLength = 12 


Result of copyO is 15 




11 


Compare the whole buffer 

Reference = 

00 01 02 

81 03 01 21 00 

02 02 82 81 

03 01 00 

OF 10 11 12 13 


Result of arrayCompareO is 




12 


Initialize dstBuffer 

dstBuffer = OOh Olh 02h ... 13h 








Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 20 
dstOffset = 3 
dstLength = 9 


Result of copyQ is 12 




13 


Compare the whole buffer 

Reference = 

00 01 02 

81 03 01 21 00 

02 02 82 81 

OC OD OE 

OF 10 11 12 13 


Result of arrayCompareO is 
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6.2.8.10.4 



Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Does not apply for 

Proactive Response 

Handler 



6.2.8.11 Method findTLV 

Test Area Reference API 2 PRH FINDBB 



6.2.8.1 1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag is 

set. 

CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension Required 
flag is not set. 

CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

CRRN5: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.8.11.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PRH_FINDBB_1 .scr 
API_2_PRH_FINDBB_1 .Java 
API_2_PRH_FINDBB_1 .Idr 
API 2 PRH FINDBB l.clr 
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6.2.8.11.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 General Result TLV 

81 03 01 21 00 

82 02 82 81 
03 01 00 

03 02 01 12 








findTLVO with Invalid input parameter 

occurrence = 


ToolkitException.BAD INPUT P 
ARAMETER is thrown 




2 


Search 1st TLV 

tag = Olh 
occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

tag = 02h 
occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

tag = 04h 
occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT shall be thrown 




8 


Search a tag with wrong occurrence 

tag = Olh 
occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT shall be thrown. 




10 


Search 3rd TLV 

tag = 03h 
occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Call the getValueLengthO method 


Result is Olh 




12 


Search 3rd TLV 

tag = 03h 
occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




13 


Call the getValueLengthO method 


Result is 02h 




14 


Search tag 83h 

Tag = 83h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




15 


Search tag 82h 

Tag = 82h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 





6.2.8.11.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,5, 11, 13 


N2 


2,4 


N3 


10, 12 


N4 


6,7,8,9 


N5 


14,15 


PI 


1 


CI 


Does not apply for 

Proactive Response 

Handler 



6.2.8.12 Method getValueLength 

Test Area Reference API_2_PRH_GVLE 
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6.2.8.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 

Normal execution 

CRRNl: gets and returns the binary length of the value field for the last TLV element which has been found in the 
handler. 

Parameter errors 
No requirements 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.8.12.2 Test Suite files 

Test Script: API_2_PRH_GVLE_l.scr 

Test Applet: API_2_PRH_GVLE_l.java 

Load Script: API_2_PRH_GVLE_l.ldr 

Cleanup Script: API_2_PRH_GVLE_l.clr 
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6.2.8.12.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 00 








ProactiveResponseHandler.getTheHandlerQ 

GetValueLength ( ) 


ToolkitException.UNAVAILABLE 
_ELEMENT is thrown 




2 


Search TLV ODh 








getValueLength ( ) 


Result is OOli 




3 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 02 04 41 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 02li 




4 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 7Fli 




5 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Fh 

Text String TLV = OD 81 80 04 01 02 ... 7E 
7F 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 80h 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... EF 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is FOh 





6.2.8.12.4 



Test Coverage 



CRR number 


Test case number 


N1 


2,3,4,5,6 


CI 


Does not apply for 

Proactive Response 

Handler 


02 


1 



6.2.8.13 Method getValueByte 

Test Area Reference API_2_PRH_GVBYS 

6.2.8.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 
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Normal execution 

CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 byte). 

Parameter errors 

CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.13.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.13.3 



Test Suite files 

API_2_PRH_GVBYS_l.scr 
API_2_PRH_GVBYS_1 .Java 
API_2_PRH_GVB YS_1 .Idr 
API_2_PRH_GVB YS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String lengthi = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








ProactiveResponseHandler.getTheHandlerQ 








getValueByte(O) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueByteO) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueByte(2) 


Result is OOh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte (0) 


Result is 82h (Source) 




5 


Search TLV ODh (Text String TLV) 








getValueByte (7E) 


Result is 7Eh 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... 7E 
7F ... EF 








Search TLV ODh (Text String TLV) 








getValueByte (7E) 


Result is 7Eh 




7 


GetValueByte (7F) 


Result is 7Fh 




8 


GetValueByte (EF) 


Result is EFh 





£75/ 



3GPP TS 11.13 version 7.2.0 Release 1998 



203 



ETSI TS 101 955 V7.2.0 (2001-09) 



6.2.8.13.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,4,5,6,7,8 


P1 


2 


CI 


Does not apply for 

Proactive Response 

Handler 


C2 


1 



6.2.8.14 Method copyValue 

Test Area Reference API_2_PRH_CPYVS_BSS 



6.2.8.14.1 



Conformance requirement 



The method with following header shall be compliant with its definition in the API. 

public short copyValue (short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException^ 
ToolkitException 

Normal execution 

CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 
CRRN2: returns dstOffset + dstLength. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException is thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.14.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PRH_CPYVS_BSS_1 .scr 
API_2_PRH_CPYVS_BSS_l.java 
API_2_PRH_CPYVS_BSS_1 .Idr 
API_2_PRH_CPYVS_BSS_1 .clr 
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6.2.8.14.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerO 

Select Text String TLV 








CopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

dstBuffer . length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Text String Length 

valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


ValueOffset + dstLength > Text String length 

ValueOffset = 2 
DstBuffer.length = 15 
DstOffset = 
DstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler . getTheHandler 








CopyValueO 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




12 


Select Text String TLV 








Successful call 

ValueOffset = 
DstBuffer.length = 17 
DstOffset = 
DstLength = 17 


Result of CopyValueO is 17 




13 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

ValueOffset = 2 


Result of CopyValueO is 15 
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DstBuffer. length = 20 
DstOffset = 3 
DstLength = 12 






15 


Compare buffer 

Buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 





6.2.8.14.4 



Test Coverage 



CRR number 


Test case number 


N1 


13,15 


N2 


12, 14 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


CI 


Does not apply for 

Proactive Response 

Handler 


02 


11 



6.2.8.15 Method compareValue 

Test Area Reference API 2 PRH CPRVS BSS 



6.2.8.15.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte[] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array IndexOut Of BoundsExcept ion, 
ToolkitException 

Normal execution 

Compares the last found TLV element with a buffer: 

CRRNl: returns if identical. 

CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 

CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 
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CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall 
be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.15.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.15.3 



Test Suite files 

API_2_PRH_CPRVS_BSS_1 .scr 
API_2_PRH_CPRVS_BSS_1 .Java 
API_2_PRH_CPRVS_BSS_1 .Mr 
API_2_PRH_CPRVS_BSS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerQ 

Select Text String TLV 








compareValueO with a null compareBuffer 


NullPointerException is tlirown 




2 


compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Text String Length 

valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkJtException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkJtException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkJtException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 
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Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler . getTheHandler ( ) 








CompareValue () 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




12 


Select Text String TLV 








Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers 

ValueOffset = 
CompareOf f set = 
CompareLength = 17 


Result is OOli 




13 


Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialise compareBuffer 

CompareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




15 


Initialise compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

ValueOffset = 2 
CompareOf f set = 3 
CompareLength = 12 


Result is OOli 




16 


Initialise compareBuffer 

CompareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialise compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 





6.2.8.15.4 



Test Coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13,16 


N3 


14, 17 


PI 


1 


P2 


2, 3, 4, 5, 6 


PS 


7,8,9, 10 


CI 


Does not apply for 

Proactive Response 

Handler 


C2 


11 



6.2.8.1 6 Method findAndCopyValue(byte tag, byteQ dstBuffer, short valueOffset) 

Test Area Reference API 2 PRH FACYB BS 
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6.2.8.16.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

Normal execution 

CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into a 
destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be thrown. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.8.16.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.16.3 



Test Suite files 

API_2_PRH_FACYB_BS_1 .scr 
API_2_PRH_FACYB_BS_1 .Java 
API_2_PRH_FACYB_BS_1 .Idr 
API_2_PRH_FAC YB_BS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler . getTheHandler ( ) 








FindAndCopyValue ( ) with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

tag = ODh 

dstBuffer.length = 20 
dstOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > dstBuffer.length 

dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + length >dstBuffer.length 

dstBuffer.length = 20 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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dstOffset = 5 






6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 04h 


ToolkltException.UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkltException.UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Successful call 

Tag = ODh 

DstBuffer. length = 17 

DstOffset = 


Result of fincJAndcopyValueO is 
17 




8 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




9 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

DstBuffer. length = 20 
DstOffset = 2 


Result of findAndcopyValueO is 
19 




10 


Compare buffer 

Buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 
OD 02 04 41 








ProactiveResponseHandler.getTheHandlerQ 








Successful call 

Tag = ODh 

DstBuffer. length = 17 

DstOffset = 


Result of findAndcopyValueO is 
17 




12 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




13 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Successful call (with tag 8Dh) 

Tag = 8Dh 

DstBuffer. length = 17 

DstOffset = 


Result of findAndcopyValueO is 
17 




14 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 
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6.2.8.16.4 



Test Coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for 

Proactive Response 

Handler 



6.2.8.17 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 



Test Area Reference API 2 PRH FACYBBS BSS 



6.2.8.17.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
Toolkit Except ion 

Normal execution 

CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

CRRN4: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.8.17.2 Test Suite files 

Test Script: API_2_PRH_FACYBBS_BSS_l.scr 
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Test Applet: 
Load Script: 
Cleanup Script: 

6.2.8.17.3 



API_2_PRH_FACYBBS_BSS_1 .Java 
API_2_PRH_FACYBBS_BSS_1 .Idr 
API_2_PRH_FAC YBBS_BSS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








findAndCopyValueQ with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerO 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Select a TLV (tag 02h) 
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findAndCopyValueO 

tag = ODh 
occurrence = 2 


ToolkltException.UNAVAILABLE 
_ELEMENT is thrown 






Call the getValueLengthO method 


ToolkltException.UNAVAILABLE 
ELEIVIENT is thrown. 




12 


Successful call 

Tag = ODh, occurrence = 1 
ValueOffset = 
DstBuffer. length = 17 
DstOffset = 
DstLength = 17 


Result of findAndCopyValueO is 
17 




13 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialise dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

Tag = ODh, occurrence = 1 
ValueOffset = 2 
DstBuffer .length = 20 
DstOffset = 3 
DstLength = 12 


Result of findAndCopyValueO is 
15 




15 


Compare buffer 

Buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 02 ... OF 

OD 06 00 11 22 33 44 55 (no specific DCS 

byte) 








ProactiveResponseHandler.getTheHandlerQ 








Successful call 

Tag = ODh, occurrence = 1 
ValueOffset = 
DstBuffer .length = 17 
DstOffset = 
DstLength = 17 


Result of findAndCopyValueO is 
17 




17 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




18 


Successful call 

Tag = ODh, occurrence = 2 
ValueOffset = 
DstBuffer . length = 6 
DstOffset = 
DstLength = 6 


Result of findAndCopyValueO is 
6 




19 


Compare buffer 

Buffer = 00 11 22 33 44 55 


Result is OOh 




20 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Successful call (with tag BDh) 

Tag = BDh, occurrence = 1 
ValueOffset = 
DstBuffer. length = 17 
DstOffset = 
DstLength = 17 


Result of findAndCopyValueO is 
17 




21 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 
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6.2.8.17.4 



Test Coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18 


N4 


20,21 


P1 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


CI 


Does not apply for 

Proactive Response 

Handler 



6.2.8.18 Method findAndCompareValue(byte tag, byteQ compareBuffer, short 
compareOffset) 



Test Area Reference API_2_PRH_FACRB_BS 



6.2.8.18.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws Java . lang. NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion. 
Toolkit Except ion 

Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 

CRRN3: if identical returns 0. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -I. 

CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1. 

CRRN6; The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 

6.2.8.18.2 Test Suite files 

Test Script: API_2_PRH_FACRB_BS_Lscr 

Test Applet: API_2_PRH_FACRB_BS_l.java 
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Load Script: 
Cleanup Script: 

6.2.8.18.3 



API_2_PRH_FACRB_BS_1 .Idr 
API_2_PRH_FACRB_BS_1 .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








FindAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = ODh 

compareBuffer.length = 20 
compareOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


length > compareBuffer.length 

compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


CompareOffset + length > 

compareBuf f er . length 
CompareBuffer.length = 20 
CompareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Select a TLV (tag 02h) 








findAndCompareValueQ 

tag = 04h 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Initialise compareBuffer 

CompareBuf fer = 
04 00 01 ... OF 








Compare buffers 

Tag = ODh 
CompareOffset = 


Result is OOh 




8 


Verify current TLV 

GetValueLengthO 


Result is 17 




9 


Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




10 


Initialise compareBuffer 

CompareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result Is +1 




11 


Initialise compareBuffer 

CompareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

CompareOffset = 2 


Result is OOh 




12 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 
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OD 06 00 11 22 33 44 55 








ProactiveResponseHandler.getThehHandlerO 








Initialise compareBuffer 

CompareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

CompareOf f set = 2 


Result is OOh 




13 


Initialise compareBuffer 

CompareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

CompareOf f set = 2 


Result Is -1 




14 


Initialise compareBuffer 

CompareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

CompareOf f set = 2 


Result is +1 




15 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers (with tag 8Dh) 

Tag = 8Dh 
CompareOf f set = 


Result is OOh 





6.2.8.18.4 



Test Coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12 


N4 


9,13 


N5 


10, 14 


N6 


15 


PI 


1 


P2 


2, 3, 4, 5 


CI 


Does not apply for 

Proactive Response 

Handler 



6.2.8.19 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, 
byteQ compareBuffer, short compareOffset, short compareLength) 

Test Area Reference API_2_PRH_FACRBBS_BSS 

6.2.8.19.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag. 
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byte occurence, 
short valueOffset, 
byte[] compareBuf f er, 
short compareOf f set, 
short compareLength) 
throws Java . lang.NullPointerException, 

Java . lang . Array I ndexOut Of Bounds Except ion. 
Toolkit Except ion 

Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV Hst and compare its value with a 
buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is 
no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 

CRRN3: if identical is returned. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 

CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 

CRRN6: The search method is comprehension required flag independent. 

Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength 
is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

CRRP4: if an input parameter is not valid (e.g. occurence = 0) an instance of ToolkitException shall be thrown. The 
reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

Context errors 

CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.8.19.2 Test Suite files 

Test Script: API_2_PRH_FACRBBS_BSS_l.scr 

Test Applet: API_2_PRH_FACRBBS_BSS_l.java 

Load Script: API_2_PRH_FACRBBS_BSS_l.ldr 

Cleanup Script: API_2_PRH_FACRBBS_BSS_l.cb- 
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6.2.8.19.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler.getlheHandierO 








findAndCompareValueQ with a null 
compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


CompareOffset + compareLength 

>compareBuf f er . length 
CompareBuffer.length = 5 
CompareOffset = 3 
CompareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerQ 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

Occurrence = 


ToolkitException.BAD INPUT P 
ARAMETER is thrown 




12 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Select a TLV (tag 02h) 
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findAndCompareValueQ 

tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
_ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




13 


Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




14 


Verify current TLV 

GetValueLength ( ) 


Result is 17 




15 


Initialise compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




16 


Initialise compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




17 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




18 


Initialise compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




19 


Initialise compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

GO 11 04 00 01 ... OF 

OD 06 00 11 22 33 44 55 








ProactiveResponseHandler.getTheHandlerQ 








Initialise compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




21 


Initialise compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareValueQ 


Result is OOh 





£75/ 



3GPP TS 11.13 version 7.2.0 Release 1998 



219 



ETSI TS 101 955 V7.2.0 (2001-09) 





tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 






22 


Initialise compareBuffer 

compareBuf fer = 
00 11 22 33 44 66 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is -1 




23 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Initialise compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers (with tag 8Dh) 

tag = 8Dh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 





6.2.8.19.4 



Test Coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17,20,21 


N4 


15, 18,22 


N5 


16, 19 


N6 


23 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


11 


C1 


Does not apply for 

Proactive Response 

Handler 



6.2.9 Class ToolkitRegistry 
6.2.9.1 Method allocateTimer 

Test Area Reference: API_2_TKR_ATIM 

6.2.9.1.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte allocateTimer ( ) throws ToolkitException 

Normal execution 

CRRNl: the returned timer identifier shall be between 01 and 08 inclusive. 

CRRN2: the returned timer identifier shall be different from a previously allocated but not released one. 
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CRRN3: The SIM Toolkit Framework shall trigger the applet when receiving an ENVELOPE(TIMER 
EXPIRATION) command for the allocated timer. 

CRRN4: A call to isEventSet() method for EVENT_TIMER_EXPIRATION should return true if the applet has at 
least one timer allocated. 

Parameters error 
No requirements 

Context errors 

CRRCl: Shall throw a ToolkitException with reason NO_TIMER_A VAIL ABLE if all the timers are allocated. 

CRRC2: Shall throw a ToolkitException with reason NO_TIMER_A VAIL ABLE if the maximum number of 
timers have been allocated to this applet according to installation parameter. 

6.2.9.1.2 Test suite files 

Test Script: API_2_TKR_ATIM_l.scr 

Test Applet: 1 . API_2_TKR_ATIM_1 .j ava 

2. API_2_TKR_ATIM_2.java 

3. API_2_TKR_ATIM_3.java 
Installation parameters: 

For this test procedure the non-volatile memory of each instance is 200 (Hexa). 
The maximum timer parameter value is as follows for each applet: 

- applet 1 (API_2_TKR_ATIM_1): 8 timers 

- applet 2 (API_2_TKR_ATIM_2): 4 timers 

- applet 3 (API_2_TKR_ATIM_3): timer 
Load Script: API_2_TKR_ATIM_Lldr 

The load script installs the 6 instances. 
Cleanup Script: API_2_TKR_ATIM_Lclr 
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6.2.9.1.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Allocates up to 8 timers 
(applet 1) 

8 * allocateTimer ( ) . 


No exception shall be thrown. 

Timer ID returned shall be between 

01 and 08 inclusive. It shall be 

different after each call. 




2 


Allocate timers more than the maximum 
(applet 1) 

The applet 1 allocates 1 more timer. 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE. 




3 


Check applet is Triggered by 

ENVELOPE(TIMER EXPIRATION) command 

(appletl) 

Send ENVELOPE (TIMER EXPIRATION) with all 
timers id (not in an increase order) . 

Calls releaseTimer (id) each time a timer 
expires . 


Shall trigger each time an 

ENVELOPE(TIMER EXPIRATION) 

is sent to the SIIVI, for Timer ID = 

'01 'to '08'. 




4 


Allocate up to 4 timers 
(applet 2) 

4 * allocateTimer . 


No exception shall be thrown. Each 
time, the returned timer identifier 

shall be between '01' and '08' 

inclusive. It shall be different after 

each call. 




5 


Allocate timers more than the maximum 
(applet 3) 

The applet 3 allocates 1 more timer. 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE. 





6.2.9.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,4 


N2 


1,4 


N3 


3 


N4 


1 


CI 


2 


C2 


5 



6.2.9.2 Method changeMenuEntry 

Test Area Reference: API_2_TKR_CMETB_BSSBZBS 

6.2.9.2.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void changeMenuEntry (byte id, 

byte[] menuEntry, 
short offset, 
short length, 
byte nextAction, 
boolean helpSupported, 
byte IconQualif ier, 
short iconldentifier) 
throws Java . lang . NullPointerException, 

Java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 
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Normal execution 

CRRNl: The SIM Toolkit Framework shall automatically update the menu stored in the ME by issuing a SET UP 
MENU proactive command. The later will reflect the changes done for the entry. The SIM Toolkit Framework 
shall use the data of the EF sume file in order to build the SET UP MENU command. 

CRRN2: The default state of the changed menu entry is 'enabled'. 

CRRN3: a call to isEventSet() method on EVENT_MENU_S ELECTION shall return true before and after the call. 

CRRN4: if helpSupported was true then a call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return true. 

CRRN5: if helpSupported was true then after the completion of the SETUP MENU command, if an 

ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the SIM for this entry, then the 
SIM Toolkit framework shall trigger the applet. 

CRRN6: if help supported was true, the SIM Toolkit Framework shall issue a SETUP MENU command with 
command qualifier = '80' 

CRRN7: if helpSupported was false and if no entries is supporting help then a call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return false . 

CRRN8: if helpSupported was false and if no entries is supporting help then after the completion of the SETUP 
MENU command, if an ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the 
SIM, then the SIM Toolkit framework shall not trigger the applet. 

CRRN9: The SIM Toolkit Framework shall supply in the SET UP MENU command with the icon identifier 

provided in the icon identifier list within the item icon identifier list Simple TLV if all the applets registered to 
the EVENT_MENU_SELECTION provide it. 

CRRNIO: The SIM Toolkit Framework shall set in the SET UP MENU command with the Icon list quaUfier 
transmitted to the ME as 'icon is not self explanatory' if one of the applet registered prefers this qualifier. 

CRRN 11 : If Next Action Indicator was different from '00', the SIM Toolkit Framework shall issue a SETUP 

MENU proactive command containing an Items Next Action Indicator simple TLV with the comprehension flag 
set to as defined in GSM 1 1.14 [4]. 

Parameters error 

CRRPl: Shall throw java.lang.NullPointerException - if menuEntry is null 

CRRP2: Shall throw Java. lang.ArraylndexOutOfBoundsException - if offset would cause access outside array 
bounds 

CRRP3: Shall throw Java. lang.ArraylndexOutOfBoundsException - if length would cause access outside array 
bounds 

CRRP4: Shall throwjava.lang.ArraylndexOutOfBoundsException - if both offset and length would cause access 
outside array bounds 

Context errors 

CRRCl: Shall throw a ToolkitException with MENU_ENTRY_NOT_FOUND reason if the Menu Identifier isn't 
associated to the calling applet instance. 

CRRC2: Shall throw ALLOWED_LENGTH_EXCEEDED if the menu entry string is bigger than the allocated 
space. 

6.2.9.2.2 Test suite files 

Additional requirements for the GSM personalisation: 
content of EF sume shall be: 
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- Title Alpha Identifier: "TOOLKIT TEST" 

Test Script: API_2_TKR_CMETB_BBSSBZBS_l.scr 

Test Applet: API_2_TKR_CMETB_BBSSBZBS_l.java 

- entry'01'is"Initl" 

- entry '02' is "Init2" 
Installation parameter: 

Same as default applet but with: 

Maximum text length for a menu entry: 15 
Maximum number of menu entries: 2 

Position / Identifier for each menu entry: '0r/'0r,'02'/'02' 
Load Script: API_2_TKR_CMETB_BBSSBZBS_Lldr 

Cleanup Script: API_2_TKR_CMETB_BBSSBZBS_Lclr 
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6.2.9.2.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet changes the entry's title by menuEntry 

buffer, with a greater length than the initial 

length 

1- ChangeMenuEntry with parameters: 

Id = '02' 

MenuEntry = "UseAllBuf f er " 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 0. 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 


1- No exception shall be thrown. 

2- shall return true. 

3- shall return false. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'02'. 


2 


Changing the title with part of menuEntry 
buffer 

1- ChangeMenuEntry with parameters: 

Id = '01' 

MenuEntry = "UsePartOf Buf f er " 
Offset = 3 
Length = 12 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 

2- isEventSet (EVENT„MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'01'. 


3 


Length = 

1- ChangeMenuEntry for entry '01' and 
entry '02', with parameters: 

Id = '01'/'02' 
MenuEntry = "LengthEqualsO" 
Offset = 
Length = 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 

2- IsEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 


1- No exception shall be thrown. 

2- Shall return true. 

3- shall return false. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains 
for entry '01 'and entry '02', 
no text part. 


4 


Setting a next action indicator != 

1- ChangeMenuEntry with parameters: 

Id = '02' 

MenuEntry = "NextActionlndic" 

Offset = 

Length = menuEntry . length 

NextAction = '10' (SETUP CALL) 

HelpSupported = false 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


The SIM shall Issue a 
SETUP MENU proactive 
command which contains an 
Items Next Action Indicator 
list and which contains a 
command qualifier '80'. 
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IconQualif ier = 
Iconldentif ier = 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 
4- changeMenuEntry ( ) with parameters: 

Id = '02' 

MenuEntry = "NextActionlndic" 

Offset = 

Length = menuEntry . length 

NextAction = '10' (SETUP CALL) 

HelpSupported = true 

IconQualif ier = 

Iconldentif ier = 






5 


Checking applet is triggered by a 
MENU_SELECTION_HELP_REQUEST 

Send ENVELOPE (MENU_SELECTION_HELP_REQUEST) 
with Item Identifier = '02' 


Applet is trigged by a 
MENU_SELECTION_HELP_REQU 
EST and tlie Item Identifier is 02 




6 


help supported=true 

1- changeMenuEntry with parameters: 

Id = '01' 

MenuEntry = "HelpSupported" 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = true 

IconQualif ier = 

Iconldentif ier = 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 


1 - No exception sliall be thrown. 

2- Shall return true. 

3- Shall return true. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains a 
command qualifier '80'. 


7 


Checking applet is triggered by a 
MENU_SELECTION_HELP_REQUEST 

Send ENVELOPE (MENU_SELECTION_HELP_REQUEST) 
with Item Identifier = '01' 


Applet is trigged by a 
MENU_SELECTION_HELP_REQU 
EST and the item Identifier is 01 




8 


Setting icons, help supported = false 

1- changeMenuEntry ( ) for entries 
' 01 ' , ' 02 ' , with parameters : 

Id = '01'/'02' 

MenuEntry = " IconQualif ier " 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = false 

IconQualif ier = '01' 

Iconldentif ier = '02' / '01' 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 


1- No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains an 
Icon Identifier List. 


9 


MenuEntry is disabled 

1- disableMenuEntry ( ' 01 ' ) . 

2- ChangeMenuEntry with parameters: 


1 - No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall return true. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the entry. Without Icon 
identifier List Simple TLV 
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Id = '01' 


4- Shall return false. 






MenuEntry = "EnableEntry " 








Offset = 








Length = menuEntry . length 








NextAction = 








HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 








3- isEventSet (EVENT_MENU_SELECTION) . 








4- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 








EQUEST) . 






10 


MenuEntry is null 


Shall throw 






changeMenuEntry ( ) with : 
MenuEntry = NULL 


java.lang.NullPointerException. 




11 


Offset causes access outside array bounds 

Id = '01' 








MenuEntry = "Violation" 


Shall throw 






Offset = menuEntry . length +1 
Length = 


java.lang.ArraylndexOutOfBoundsE 






NextAction = 


xception. 






HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 






12 


Big Offset causes access outside array bounds 

Id = '01' 








MenuEntry = "Violation" 


Shall throw 






Offset = 255 
Length = 1 


java.lang.ArraylndexOutOfBoundsE 






NextAction = 


xception. 






HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 






13 


Offset < causes access outside array bounds 

Id = '01' 








MenuEntry = "Violation" 


Shall throw 






Offset = -1 
Length = 1 


java.lang.ArraylndexOutOfBoundsE 






NextAction = 


xception. 






HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 






14 


Length causes access outside array bounds 

Id = '01' 








MenuEntry = "Violation" 


Shall throw 






Offset = 


java.lang.ArraylndexOutOfBoundsE 






Length = MenuEntry . length + 1 


xception. 






NextAction = 








HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 0. 






15 


Length < causes access outside array 
bounds 

Id = '01' 








MenuEntry = "Violation" 


Shall throw 






Offset = 


java.lang.ArraylndexOutOfBoundsE 






Length = -1 


xception. 






NextAction = 








HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 0. 
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16 


Both offset and length causes access outside 
array bounds 








Id = '01' 

MenuEntry = "Violation" 


Shall throw 






Offset e [1, MenuEntry . length] 


java.lang.ArraylndexOutOfBoundsE 






Length = MenuEntry . length 


xception. 






NextAction = 1 








HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 






17 


Invalid ID used 

Id = '00' 








MenuEntry = contains text, != null 
Offset = 

Length = menuEntry . length < 16 
NextAction = 


Shall throw a ToolkitException with 
MENU_ENTRY_NOT_FOUND 
reason code. 






HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 






18 


ID isn't allocated to a menu entry of this applet 
instance 

Id = 'OA' 








MenuEntry = contains text, != null 
Offset = 

Length = menuEntry . length < 16 
NextAction = 


Shall throw a ToolkitException with 
reason code: 
MENU_ENTRY_NOT_FOUND. 






HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 






19 


The text is bigger than the allocated space 

Id = '02' 

MenuEntry = contains text, != null 








Offset = 


Shall throw a ToolkitException with 






Length = menuEntry . length > 15 


reason code: 






NextAction = 


ALLOWED_LENGTH_EXCEEDED. 






HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 






20 


With a smaller text length than the initial length 

1. changeMenuEntry with parameters: 
Id = '02' 








MenuEntry = "Init" 
Offset = 


1 . No exception shall be thrown. 






Length = menuEntry . length 
NextAction = 


2. Shall return true. 






HelpSupported = false 








IconQualif ier = 


3. Shall return false. 


The SIM shall issue a 




Iconldentif ier = 




SETUP MENU proactive 




2 . isEventSet (EVENT__MENU_SELECTION) 




command which contains 
the new text for entry ID 




3. 




'02'. 




isEventSet (EVENT_MENU_SELECTION_HELP_R 








EQUEST) 
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6.2.9.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4,6,8,9,20 


N2 


9 


N3 


1,2,3,4,6,8,9,20 


N4 


6 


N5 


7,5 


N6 


6 


N7 


1,2,3,4,8,9,20 


N8 


To be checked in framework 

tests and insert cross reference 

here 


N9 


8,9 


N10 


8 


Nil 


4 


P1 


10 


P2 


11,12,13 


P3 


14,15 


P4 


16 


C1 


17,18 


C2 


19 



6.2.9.3 Method clearEvent 

Test Area Reference: API_2_TKR_CEVTB 

6.2.9.3.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void clearEvent (byte event) 

throws ToolkitException 

Normal execution 

CRRNl: A call to isEventSet() method for a cleared event should return false after a call to clearEvent. 

CRRN2:The SIM Toolkit Framework shall not trigger the applet on the occurrence of the cleared event anymore. 

CRRN3: if event was EVENT_CALL_CONTROL_BY_SIM and after the call, no applet is registered to it, The SIM 
Toolkit Framework shall allow an applet to register to this event. 

CRRN4: if event was EVENT_CALL_CONTROL_BY_SIM and one applet is still registered to these event, The 
SIM Toolkit Framework shall not allow an applet to register to this event. 

CRRN5: if event was EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM and after the call, no applet is 
registered to it, The SIM Toolkit Framework shall allow an applet to register to this event. 

CRRN6: if event was EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM and one applet is still registered to 
these event, The SIM Toolkit Framework shall not allow an applet to set this event. 

Parameters error 

CRRPl: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_MENU_SELECTION. 

CRRP2: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP3: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_TIMER_EXPIRATION. 
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CRRP4: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_STATUS_COMMAND. 

Context errors 
No requirements 



6.2.9.3.2 
Test Script: 
Test Applet: 



Test suite files 
API_2_TKR_CEVTB_1 .scr 
API_2_TKR_ CEVTB _l.java 



As default but applet registers to an event list which contains all defined events in GSM 03.19 [7] excepted 
those that aren't allowed or supported by setEvent(). 



Load Script: 
Cleanup script: 

6.2.9.3.3 



API_2_TKR_ CEVTB_l.ldr 
API_2_TKR_ CEVTB_l.clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear ALLOWED unregistered events 

For events ranging from 1 to 127 excepted 
those that aren't allowed 
(EVENT_MENU_SELECTION, 
EVENT_MENU_SELECTION_HELP_REQUEST, 
EVENT_TIMER_EXPIRATION, 
EVENT_STATUS_COMMAND) , 
the applet calls: 

1- clearEventO method 

2- isEventSetO method 


1 - No exception is tlirown each 
time. 

2- Sliall return false each time. 




2 


Clear registered events 

1- For each ALLOWED and SUPPORTED events, 
the applet calls setEvent() method. 

2- For events ranging from 1 to 127 
excepted those that aren't allowed, the 
applet calls: 

2.1- ClearEventO method 

2.2- isEventSetO method 


1 - No exception shall be thrown. 

2.1- No exception shall be thrown. 

2.2- Shall return false. 




3 


Clearing NOT ALLOWED events 

For each event among: 

EVENT_MENU_SELECTION, 

EVENT_MENU_SELECTION_HELP_REQUEST, 

EVENT_TIMER_EXPIRATION, 

EVENT_STATUS_COMMAND 

1- The applet calls clearEvent (event ) 
method. 


1 - Each time, clearEvent shall 
throw a Toolkit Exception with 
reason EVENT_NOT_ALLOWED. 




4 


Checking applet isn't triggered by an 
ENVELOPE(SMS-PP DOWNLOAD) command 

1 - reset and initialise the card 

2 - An ENVELOPE (SMS-PP DOWNLOAD) is sent 
with a TAR referencing applet. 


Applet is not trigged by an 
ENVELOPE(SMS-PP 
DOWNLOAD) command 
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6.2.9.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


4 


N3 


Framework 


N4 


Framework 


N5 


Framework 


N6 


Framework 


P1 


3 


P2 


3 


P3 


3 


P4 


3 



6.2.9.4 Method disableMenuEntry 

Test Area Reference: API_2_TKR_DMETB 

6.2.9.4.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void disableMenuEntry (byte id) 
throws ToolkitException 

Normal execution 

CRRNl: A call to isEventSet() method on EVENT_MENU_SELECTION shall return the same result before and 
after the call to disableMenuEntryO method. 

CRRN2: A call to isEventSet() method on EVENT_MENU_SELECTION_HELP_REQUEST shall return the same 
result before and after the call to disableMenuEntryO method. 

CRRN3: After invocation of this method the SIM Toolkit Framework should dynamically update the menu stored 
in the ME . 

CRRN4: After invocation of this method, if there is no more enabled menu entries then the SIM Toolkit framework 
shall issue a SETUP MENU proactive command containing Item Data Object for Item 1 TLV with a length of 
zero and no value part. 

Parameters error 

No requirements 

Context errors 

CRRCl: shall throw a ToolkitException with reason = ENTRY_NOT_FOUND if the menu entry doesn't exist for 
this applet 

6.2.9.4.2 Test suite files 
Additional requirements for the GSM personalisation: 

content of EF sume shall be: 

- Tide Alpha Identifier: "TOOLKIT TEST" 
Test Script: API_2_TKR_DMETB_l.scr 

Test Applet: API_2_TKR_DMETB_l.java 

Installation parameter: 

Same as default applet but with: 



£75/ 



3GPP TS 11.13 version 7.2.0 Release 1998 



231 



ETSI TS 101 955 V7.2.0 (2001-09) 



- Maximum text length for a menu entry: 15 

- Maximum number of menu entries: 2 

Position / Identifier for each menu entry: 'Ol'/'Ol', '02'/'02' 
Load Script: APl_2_TKR_DMETB_l.ldr 

Cleanup script: APl_2_TKR_DMETB_l.clr 



6.2.9.4.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Check the menu state before 

disabling a previously enabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- reset and initialise the card 

2- isEventSet (EVENT_MENU_SELECTION) 
3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1- Shall return true 

2- Shall return false 


1- The SIM shallissue a 
SET UP MENU proactive 
command with entry '01' 
and '02'. 


2 


Check the menu state after 

disabling a previously enabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- disableMenuEntry ( ' 01 ' ) 

2- IsEventSet (EVENT_MENU_SELECTION) 
3 — 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1- No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entry '02' 
only. 


3 


Check the menu before 

disabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- change Menu Entry '02' to indicate 
help supported 

2- isEventSet (EVENT_MENU_SELECTION) 
3 — 

IsEventSet (EVENT_MENU_SELECTION_HELP__R 
EQUEST) 


2- Shall return true 

3- Shall return true 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entry '02', 
indicating help supported. 


4 


Check the menu after 

disabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- disableMenuEntry ( '02' ) 

2- isEventSet (EVENT_MENU_SELECTION) 
3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with 1st Item TLV 
with a length of 0. 


5 


Disabling invalid entries 

For ID ranging from '00' to ' FF ' except 
'01' and '02', the applet calls 
disableMenuEntry (ID) method. 


Each time a Toolkit Exception with 
MENU_ENTRY_NOT_FOUND 
reason code shall be thrown. 
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6.2.9.4.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,2,3,4 


N3 


2,4 


N4 


4 


C1 


5 



6.2.9.5 Method enableMenuEntry 

Test Area Reference: API_2_TKR_EMETB 

6.2.9.5.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void enableMenuEntry (byte id) 
throws ToolkitException 

Normal execution 

CRRNl: A call to isEventSet() method on EVENT_MENU_S ELECTION shall return the same result before and 
after the call to enableMenuEntryO method. 

CRRN2: A call to isEventSet() method on EVENT_MENU_SELECTION_HELP_REQUEST shall return the same 
result before and after the call to enableMenuEntryO method. 

CRRN3:The SIM Toolkit Framework should dynamically issue a SETUP MENU proactive command which does 
contain an ITEM SIMPLE TLV object for this entry. 

Parameters error 
No requirements 

Context errors 

CRRCl: shall throw a ToolkitException with reason = MENU_ENTRY_NOT_FOUND if the menu entry doesn't 
exist for this applet 

6.2.9.5.2 Test suite files 
Additional requirements for the GSM personalisation: 

content of EF sume shall be: 

- Title Alpha Identifier: "TOOLKIT TEST" 
Test Script: API_2_TKR_EMETB_l.scr 
Test Applet: API_2_TKR_EMETB_l.java 

Installation parameter: 

Same as default applet but with: 

- Maximum text length for a menu entry: 15 

- Maximum number of menu entries: 2 

Position / Identifier for each menu entry: 'Ol'/'Ol', '027'02' 
Load Script: API_2_TKR_EMETB_l.ldr 

Cleanup script: API_2_TKR_EMETB_l.clr 
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6.2.9.5.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Check menu state before 

enabling a previously disabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 


1- 


Shall return true 






1- isEventSet (EVENT_MENU_SELECTION) 
2- 

isEventSet (EVENT MENU SELECTION HELP R 


2- 


Shall return false 


3- The SIM shall issue a 




3- 


No exception shall be thrown. 


SET UP MENU proactive 




EQUEST) 






command with entry '02' 




3- disableMenuEntry ( '01' ) 






only. 


2 


Check menu state after 

enabling a previously disabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 










1- enableMenuEntry ( ' 01 ' ) 


1- 


No exception shall be thrown. 


3- The SIM shall issue a 




2- isEventSet (EVENT_MENU_SELECTION) 


2- 


Shall return true. 


SET UP MENU proactive 




isEventSet (EVENT_MENU_SELECTION_HELP_R 


3- 


Shall return false. 


command with entry '01' 




EQUEST) 






and '02'. 


3 


Check menu state before 

enabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- change Menu Entry '02' to indicate 
help supported 






4- The SIM shall issue a 




2- isEventSet (EVENT_MENU_SELECTION) 


2- 


Shall return true 


SET UP MENU proactive 




isEventSet (EVENT MENU SELECTION HELP R 


3- 


Shall return true 


command with entry '01'. 




EQUEST) 


4- 


No exception shall be thrown 


The help information 




4- disableMenuEntry (' 02 ' ) 






available flag. is not verified 


4 


Check menu state after 

enabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 






3- The SIM shall issue a 




1- enableMenuEntry (' 02 ') . 

2- isEventSet (EVENT_MENU_SELECTION) 


1- 
2- 


No exception shall be thrown. 
Shall return true. 


SET UP MENU proactive 
command with entries '01' 




isEventSet (EVENT_MENU_SELECTION_HELP_R 


3- 


Shall return true. 


and '02' indicating help 




EQUEST) 






supported. 


5 


Enabling invalid entries 










For ID ranging from '00' to ' FF ' except 


Each time a Toolkit Exception with 






'01' and '02', the applet calls 


MENU ENTRY NOT FOUND 






enableMenuEntry (ID) method. 


reason code shall be thrown. 





6.2.9.5.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,2,3,4 


N3 


1,2,3,4 


CI 


5 



6.2.9.6 Method getEntry 

Test Area Reference: API_2_TKR_GETY 
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6.2.9.6.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public static ToolkitRegistry getEntryO 
throws ToolkitException 

Normal execution 

CRRNl: returns a reference to the applet ToolkitRegistry object of the calling applet. 

CRRN2: Each successive call to getEntryO method shall return the same object. 
Parameters error 



No requirements 

6.2.9.6.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 

6.2.9.6.3 



Test suite files 
API_2_TKR_GETY_1 .scr 
API_2_TKR_GETY_1 .j ava 
API_2_TKR_GETY_1 .Idr 
API_2_TKR_GETY_1 .ck 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Installalation 

In the constructor, the applet instance 
calls the getEntry() method. 


Returns a not null ToolkitRegistry 
instance. 




2 


Check it returns the same entry 

The applet calls the getEntry() method 
again. 


Returns the same ToolkitRegistry 
instance as for test case 1 . 





6.2.9.6.4 



Test Coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 



6.2.9.7 Method getPolllnterval 

Test Area Reference: API_2_TKR_GPOL 

6.2.9.7.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getPolllnterval ( ) 

Normal execution 

CRRNl: shall return a value between 1 and 15300 if applet is registered to EVENT_STATUS_COMMAND event. 

CRRN2: shall return POLL_NO_DURATION value (0) if the toolkit applet is not registered to 
EVENT STATUS COMMAND event. 
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Parameters error 
No requirements. 

Context errors 
No requirements. 

6.2.9.7.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 

6.2.9.7.3 



Test suite files 
API_2_TKR_GPOL_l .scr 
API_2_TKR_ GPOL_l.java 
API_2_TKR_ GPOL_l.ldr 
API_2_TKR_ GPOL_l .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet Isn't registered to 
EVENT_STATUS_COMMAND 

getPollInterval . 


Shall return 0. 




2 


Requesting max duration 

1- requestPollInterval (15300) 

2- Reset and initialize the card 

3- getPollInterval ( ) 


1- No exception shall be thrown. 

3- Shall return a value between 1 
and 15300. 




3 


Requesting System Duration 

1- 

requestPollInterval (POLL_SYSTEM_DURATI 
ON) 

2- Reset and initialize the card 

3- getPollInterval . 


1- No exception shall be thrown. 
3- Shall return a value between 1 
and 15300. 




4 


Requesting no Duration 

1- requestPollInterval (POLL_NO_DURATION) 

2- Reset and initialize the card 

3- getPollInterval . 


1 - No exception shall be thrown. 
3- Shall return 0. 





6.2.9.7.4 



Test Coverage 



CRR number 


Test case number 


N1 


2,3 


N2 


1,4 



6.2.9.8 Method initMenu Entry 

Test Area Reference: API_2_TKR_IMET_BSSBZBS 



£75/ 



3GPP TS 1 1 .1 3 version 7.2.0 Release 1 998 236 ETSI TS 1 01 955 V7.2.0 (2001 -09) 

6.2.9.8.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte initMenuEntry (byte [ ] menuEntry, 
short offset, 
short length, 
byte nextAction, 
boolean helpSupported, 
byte IconQualif ier, 
short iconldentif ier ) 
throws Java , lang, NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
Toolkit Except ion 

Normal execution 

CRRNl: The SIM Toolkit Framework shall automatically update the menu stored in the ME by issuing a SETUP 
MENU proactive command. The later will reflect the changes done for the entry. The SIM Toolkit Framework 
shall use the data of the EF sume file in order to build the SET UP MENU command. 

CRRN2: a call to isEventSet() method on EVENT_MENU_SELECTION shall return true after the l" successful 
call (without an exception). 

CRRN3: if helpSupported was true then a following call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return true . 

CRRN4: if helpSupported was true then after the completion of the SETUP MENU command, if an 

ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the SIM for this entry, then the 
SIM Toolkit framework shall trigger the applet. 

CRRN5: if help supported was true, the SIM Toolkit Framework shall issue a SETUP MENU command with 
command qualifier = '80' 

CRRN6: if helpSupported was false and there isn't any menu entry supporting help then a call to isEventSet() 
method on EVENT_MENU_SELECTION_HELP_REQUEST event shall return false. 

CRRN7: The SIM Toolkit Framework shall supply in the SET UP MENU command with the icon identifier 

provided in the icon identifier list within the item icon identifier list Simple TLV if all the applets registered to 
the EVENT_MENU_SELECTION provide it. 

CRRN8: The SIM Toolkit Framework shall set in the SET UP MENU command with the Icon list qualifier 
transmitted to the ME as 'icon is not self explanatory' if one of the applet registered prefers this qualifier. 

CRRN9: If Next Action Indicator was different from '00', the SIM Toolkit Framework shall issue a SETUP 

MENU proactive command containing an Items Next Action Indicator simple TLV with the comprehension flag 
set to 0. 

CRRNIO: After the completion of the SETUP MENU command, if an ENVELOPE (MENU_SELECTION) 
command is received by the SIM for this identifier, then the SIM Toolkit framework shall trigger the applet. 

Parameters error 

CRRPl: Shall throwjava. lang. NullPointerException - if menuEntry is null 

CRRP2: Shall throw java.lang. ArraylndexOutOfBoundsException - if offset would cause access outside array 
bounds 

CRRP3: Shall throw Java. lang. ArraylndexOutOfBoundsException - if length would cause access outside array 
bounds 

CRRP4:Shall throw java.lang. ArraylndexOutOfBoundsException - if both offset and length would cause access 
outside array bounds 
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Context errors 

CRRCl: Shall throw ALLOWED_LENGTH_EXCEEDED if the menu entry string is bigger than the allocated 
space 

CRRC2: Shall throw REGISTRY_ERROR if the menu entry cannot be initialised (eg no more item data in applet 
loading parameter) 

6.2.9.8.2 Test suite files 

Additional requirements for the GSM personalisation: 
content of EF sume shall be: 

- Title Alpha Identifier: "TOOLKIT TEST" 
Test case trigger: 1- Applet instantiation 

2- Menu selection 

3- Menu selection Help Supported 

Test Script: API_2_TKR_IMET_BSSBZBS_l.scr 

Test Applet: API_2_TKR_IMET_BSSBZBS_l.java 

Installation parameter: 

Same as default applet but with: 

- Maximum text length for a menu entry: 15 
Maximum number of menu entries: 6 

- Position / Identifier for each menu entry: 'Ol'/'Ol', '02702', '03'/'03', '04'/'04', '05'/'05', and '06'/'06' 
Load Script: API_2_TKR_IMET_BSSBZBS_Lldr 

Cleanup script: API_2_TKR_IMET_BSSBZBS_Lclr 



6.2.9.8.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to menuEntry 

MenuEntry = NULL 


Shall throw a 
java.lang.NullPointerException. 




2 


Offset > menuEntry.length 

MenuEntry = "ToolkitTest" 
Offset = 12 
Length = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




3 


Offset < 

MenuEntry = "ToolkitTest" 
Offset = -1 
Length = 11 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




4 


Offset = 255 

MenuEntry = "ToolkitTest" 
Offset = 255 
Length = 11 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




5 


Length = menuEntry.length+1 

MenuEntry = "ToolkitTest" 
Offset = 
Length = 12 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




6 


Length < 

MenuEntry = "ToolkitTest" 
Offset = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 
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Length = -1 






7 


Offset + length > menuEntry.length 

MenuEntry = "ToolkitTest " 
Offset = 11 
Length = 1 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




8 


MenuEntry.length > size allocated at loading 
for each menu entry 

MenuEntry = "ToolkitTest impossible" 
Offset = 
Length = 16 


ALLOWED_LENGTH_EXCEEDED 
ToolkitException is thrown. 




9 


Successful call, 
menuEntry is the whole buffer 

1- initMenuEntry ( ) 

MenuEntry = "TOOLKIT TEST 1" 
Offset = 
Length = 14 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 

2- isEventSet (EVENT_MENU_SELECTION) 


1 - No exception shall be thrown, 
Shall return ID '01'. 

2- Shall return true. 




10 


Successful call, 
menuEntry part of a buffer 

1- initMenuEntry ( ) 

MenuEntry = " 1234567TOOLKIT TEST 2" 

Offset = 7 

Length = 14 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 

2- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1- No exception shall be 
thrown, Shall return ID '02'. 

2- Shall return false. 




11 


Successful call, 
menuEntry with help supported 

1- initMenuEntry ( ) 

MenuEntry = "TOOLKIT TEST 3" 
Offset = 
Length = 14 
NextAction = '00' 
HelpSupported = true 
IconQualif ier = '00' 
Iconldentif ier = 

2- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 - No exception shall be thrown. 
Shall return ID '03' 
2- Shall return true. 




12 


Successful call, 
menuEntry with an Icon 

MenuEntry = "TOOLKIT TEST 4" 

Offset = 

Length = 14 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '01' [icon not self 

explanatory] 

Iconldentif ier = 1 


1 - No exception shall be thrown. 
2- Shall return ID '04' 




13 


Successful call. 


1 - No exception shall be thrown. 
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menuEntry with a next action indication 

MenuEntry = "TOOLKIT TEST 5" 

Offset = 

Length = 14 

NextAction = '24' [Select Item] 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 


2- Shall return ID '05' 




14 


Successful call, 
length = 

initMenuEntry ( ) 

MenuEntry = "ToolkitTest" 
Offset = 
Length = 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


No exception shall be thrown, Shall 
return ID '06'. 




15 


Initialize more entry than allocated at loading 

MenuEntry = "ToolkitTest" 
Offset = 
Length = 11 


REGISTRY_ERROR 
Tooll<itException is thrown. 




16 


Dynamic update of the menu stored by the me 

Fetch 




Card shall Send a 

SetUpMenu Proactive 

command: 

[CommandOualifier]=help 

supported 

[Alphald]="TOOLKIT TEST" 

[ltemld=1] = "TOOLKIT 

TEST 1 " 

[ltemld=2] = "TOOLKIT 

TEST 2" 

[ltemld=3] = "TOOLKIT 

TEST 3" 

[ltemld=4] = "TOOLKIT 

TEST 4" 

[ltemld=5] = "TOOLKIT 

TEST 5" 

[ltemld=6] = "" 

[ltemsNextAction]=0600000 

0002400 


17 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = ' 01 ' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & IVIenu Entry ID = '01' 




18 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = ' 02 ' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & IVIenu Entry ID = '02' 




19 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '03' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & IVIenu Entry ID = '03' 




20 


Check Applet is triggered by 
ENVELOPE(IVIENU_SELECTION) command 

Menu Entry ID = ' 04 ' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & IVIenu Entry ID = '04' 




21 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = ' 05 ' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & IVIenu Entry ID = '05' 
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22 


Check Applet is triggered by ENVELOPE 
(MENU_SELECTION_HELP_REQUEST) 
command 

Menu Entry ID = '03' 


Applet is trigged by an 
ENVELOPE(MENU SELECTION 
HELP_REOUEST) command & 
IVIenu Entry ID = '03' 




23 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '06' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & IVIenu Entry ID = '06' 





6.2.9.8.4 



Test Coverage 



CRR number 


Test case number 


N1 


16 


N2 


9 


N3 


11 


N4 


22 


N5 


11,16 


N6 


10 


N7 


12,16 


N8 


12,16 


N9 


13,16 


N10 


9,10,11,12,13,14,17,18,19,20,2 
1,23 


P1 


1 


P2 


2,3,4 


P3 


5,6 


P4 


7 


C1 


8 


C2 


14 



6.2.9.9 Method isEventSet 

Test Area Reference: API_2_TKR_IEVSB 

6.2.9.9.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public boolean isEventSet (byte event) 

Normal execution 

CRRNl: shall return true if the event is set in the Toolkit Registry for the applet 
CRRN2: shall return false if the event isn't set in the Toolkit Registry for the applet 

Parameters error 
No requirements. 

Context errors 
No requirements 
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6.2.9.9.2 
Test Script: 
Test Applet: 



Test suite files 
API_2_TKR_IEVSB_1 .scr 
API_2_TKR_ lEVSB _l.java 



Installation parameter: 

Same as default applet but with: 

Maximum text length for a menu entry: 15 
Maximum number of menu entries: 1 

Position / Identifier for each menu entry: 'Ol'/'Ol' 
- Maximum number of timers: 1 

Load Script: API_2_TKR_ IEVSB_1 .Idr 

Cleanup script: API_2_TKR_ IEVSB_1 .clr 



6.2.9.9.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Events aren't set 

Applet calls isEventSetO for each events 
ranging from 1 to 127 excepted 
EVENT_FORMATTED_SMS_PP_ENV and 
EVENT_MENU_SELECTION. 


Shall return false each time. 




2 


For EVENT_FORMATTED_SMS_PP_ENV 

isEventSet (EVENT_FORMATTED_SMS_PP_ENV) 


Shall return true. 




3 


For EVENT_MENU_SELECTION 

isEventSet (EVENT_MENU_SELECTION) 


Shall return true 




4 


After clearing 
EVENT_FORMATTED_SMS_PP_ENV 

1- clearEvent (EVENT_FORMATTED_SMS_PP_ENV) 

2- 

isEventSet (EVENT_FORMATTED_SMS_PP_ENV) 


1 - No exception shall be thrown. 
2- Shall return false. 




5 


Setting events 

1- For each SUPPORTED and ALLOWED events 
for setEvent(), applet calls: 

1.1- setEventO method 

1.2- IsEventSet method. 


1.1- No exception shall be 
thrown. 

1 .2- Shall return true each time. 




6 


For 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- IsEventSet 
(EVENT_MENU_SELECTION_HELP_REQUEST) 

2- call changeMenuEntry with help 
supported 

3- IsEventSet 
(EVENT_MENU_SELECTION_HELP„REQUEST) 


1- Shall return false. 
3- Shall return true 




7 


For EVENT_TIMER_EXPIRATION 

1- IsEventSet (EVENT_TIMER_EXPIRATION) 


1- Shall return false. 
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2- call allocateTimer 

3- isEventSet (EVENT_TIMER_EXPIRATION) 


3- Shall return true 




8 


For EVENT_STATUS_COMMAND 

1- isEventSet (EVENT_STATUS_COI«AND) 

2- call 

requestPoll Interval (POLL_SYSTEM_DURATION) 

3- IsEventSet (EVENT_STATUS_COMMAND) 


1- Shall return false. 
3- Shall return true 





6.2.9.9.4 



Test Coverage 



CRR number 


Test case number 


N1 


2,3,4,5,6,7,8 


N2 


1,5,6,7,8 



6.2.9.10 Method releaseTimer 

Test Area Reference: API_2_TKR_RTIMB 

6.2.9.10.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void releaseTimer (byte timerldentif ier) 
throws ToolkitException 

Normal execution 

CRRNl: if it was the last allocated timer for the applet then a following call to isEventSet() method for 
EVENT_TIMER_EXPIRATION should return false. 

CRRN2: if applet has timers allocated then a call to isEventSet(EVENT_TIMER_EXPIRATION) shall return true. 

CRRN3: After invocation of the method the indicated timer shall be released and available for reallocation. 

CRRN4: The applet is deregistered of the EVENT_TIMER_EXPIRATION for the indicated Timer Identifier. 

Parameters error 

CRRPl: shall throw a ToolkitException with INVALID_TIMER_ID reason if the timer identifier isn't between 1 
and 8. 

Context errors 

CRRCl: shall throw a ToolkitException with INVALID_TIMER_ID reason if the timer is valid but isn't allocated to 
this applet. 



6.2.9.10.2 
Test Script: 
Test Applet: 



Test suite files 
API_2_TKR_RTIMB_1 .scr 
API_2_TKR_RTIMB_1 .Java 



Installation parameter: 

As Default, except max timer which is set to 8. 
Load Script: API_2_TKR_RTIMB_l.ldr 

Cleanup script: API_2_TKR_RTIMB_l.clr 
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6.2.9.10.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Releasing not allocated timers 

For each timer ID ranging from '00' to 
'FF', applet calls releaseTimer (ID) . 


Each time, method shall throw a 
ToolkitException with reason code 
INVALID_TIMER_ID. 




2 


Releasing allocated timers 

1- 8 * allocateTimer . 

2- 7 * releaseTimer (id) . 

3- isEventSet (EVENT_TIMER_EXPIRATION) 


1 - No exception shall be thrown. 

2- Each time, no exception shall be 
thrown. 

3- Shall return true 




3 


Releasing invalid timer ID 

1- releaseTimer ( 'FF ' ) method 

2- isEventSet (EVENT_TIMER_EXPIRATION) 


1 - Shall throw a ToolkitException 
with INVALID_TIMER_ID reason 
code. 

2- Shall return true. 




4 


Releasing last timer 

1- releaseTimer (last timer allocated) 

2- IsEventSet (EVENT_TIMER_EXPIRATION) 


1 - No exception shall be thrown. 
2- Shall return false. 




5 


Checking we can allocate timers after they 

have been released 
8 * allocateTimer . 


No exception shall be thrown. 




6 


Releasing all timers. 

For 1 to 8, releaseTimer (id) . 


No exception shall be thrown. 




7 


Checking applet isn't triggered by 

ENVELOPE (TIMER_EXPIRATION) command 
Send ENVELOPE (TIMER_EXPIRAT ION) 


Applet is not trigged by an 

ENVELOPE(TIMER_EXPIRATION) 

command 





6.2.9.10.4 



Test Coverage 



CRR number 


Test case number 


N1 


4 


N2 


2,3 


N3 


5,6 


N4 


7 


P1 


1,3 


C1 


Framework 



6.2.9.11 Method requestPolllnterval 

Test Area Reference: API_2_TKR_RPOLS 

6.2.9.1 1 .1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void requestPolllnterval (short duration) 
throws ToolkitException 
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Normal execution 

CRRNl: If duration is between 1 and 15300 or equal to POLL_SYSTEM_DURATION, the applet registers to 
EVENT_STATUS_COMMAND. 

CRRN2: If duration is POLL_NO_DURATION, the applet is deregistered from EVENT_STATUS_COMMAND. 

Parameters error 

CRRPl: the method should throw a ToolkitException with REGISTRY_ERROR reason if duration is > 15300 or is 
< -1 (P0LL_SYSTEM_DURAT10N). 



Context errors 

No Requirements. 

6.2.9.11.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 

6.2.9.11.3 



Test suite files 
APl_2_TKR_RPOLS_l .scr 
AP1_2_TKR_RP0LS_1 .Java 
AP1_2_TKR_RP0LS_1 .Idr 
APl_2_TKR_RPOLS_l .clr 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Requesting a value between 1 and 15300 s 

1- isEventSet (EVENT_STATUS_COMMMAND) 

2- For duration ranging from 1 to 15300, 
requestPollInterval (duration) . 

3- isEventSet (EVENT_STATUS_COMMAND) . 


1- Shall return false. 

2- No exception shall be thrown. 

3- Shall return true. 




2 


1- Check Applet is triggered by a STATUS 
commandreset and card initialisation 

2- Send STATUS command 


2- Applet is trigged by a STATUS 
command 




3 


Requesting POLL SYSTEM DURATION 

1- isEventSet (EVENT_STATUS_COMMMAND) . 

2- 

RequestPollInterval (POLL_SYSTEM_DURATI 
ON) . 

3- IsEventSet (EVENT_STATUS_COMMAND) . 


1- Shall return true. 

2- No exception shall be thrown. 

3- Shall return true. 




4 


Check Applet is triggered by a STATUS 
command 

1- reset and card initialisation 

2- Send STATUS command 


2- Applet is trigged by a STATUS 
command 




5 


Requesting invalid duration 

For duration ranging from 15301 to 15305, 
-2 requestPollInterval (duration) 


Each time, a ToolkitException with 
REGISTRY_ERROR reason code, 
shall be thrown. 




6 


Requesting POLL NO DURATION 

1- IsEventSet (EVENT_STATUS_COMMMAND) 

2- requestPollInterval (POLL_NO_DURATION) 

3- isEventSet (EVENT_STATUS_COMMAND) 


1- Shall return true. 

2- No exception shall be thrown. 

3- Shall return false. 
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7 


Check Applet isn't triggered by an STATUS 
command. 

1- reset and card initialisation 

2- Send STATUS command 


2- Applet is not trigged by a 
STATUS command 





6.2.9.11.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


6,7 


P1 


5 



6.2.9.12 Method setEvent 

Test Area Reference: API_2_TKR_SEVTB 

6.2.9.12.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public void setEvent (byte id) 

throws ToolkitException 

Normal execution 

CRRNl: a following call to isEventSet() method with the same event id shall answer true for the applet. 

CRRN2: the SIM Toolkit Framework shall trigger the applet if an occurrence of the set event happens. 

CRRN3: this method shall accept all the events defined in GSM 0319 excepted: EVENT_MENU_SELECTION, 
EVENT_MENU_SELECTION_HELP_REQUEST, EVENT_TIMER_EXPIRATION , 
EVENT_STATUS_COMMAND 

Parameters error 

CRRPl: shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if event is 0. 

CRRP2: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_MENU_SELECTION. 

CRRP3: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP4: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_TIMER_EXPIRATION. 

CRRP5: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_STATUS_COMMAND. 

Context errors 

CRRCl: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if event is 
EVENT_CALL_CONTROL_BY_SIM but another applet is already registered to it. 

CRRC2: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if event is 

EVENT_MO_SHORT_MESSAGE_CONTROL_B Y_SIM but another applet is already registered to it. 

6.2.9.12.2 Test suite files 

Test Script: API_2_TKR_SEVTB_l.scr 
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Test Applet: 

Load Script: 

Cleanup script: 
6.2.9.12.3 



1. API_2_TKR_SEVTB_l.java 

2. API_2_TKR_SEVTB_2.java 
API_2_TKR_SEVTB_1 .Idr 

The load script installs the 2 instances. 
API_2_TKR_SEVTB_1 .clr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet 1 is triggered by ENVELOPE(SMS 
PP_FORMATTED) command. 

Send ENVELOPE (SMS_PP_FORMATTED) 


Applet 1 shall be triggered 




2 


Setting ALLOWED and SUPPORTED events 

1- For all events defined in GSM 0319 
(from 1 to 19) and allowed: 
EVENT_PROF I LE_DOWNLOAD , 
EVENT_FORMATTED_SMS_PP_ENV, 
EVENT_FORMATTED_SMS_PP_UPD , 
EVENT_UNFORMATTED_SMS_PP_ENV, 
EVENT_UNFORMATTED_SMS_PP_UPD , 
EVENT_UNFORMATTED_SMS_CB , 
EVENT_CALL_CONTROL_B Y_S IM, 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM, 
EVENT_EVENT_DOWNLOAD_MT_CALL, 
EVENT_EVENT_DOWNLOAD_CALL_CONNECTED, 
EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED, 
EVENT_EVENT_DOWNLOAD_LOCATION_STATUS, 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 
EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABL 
E, 
EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

1.1- clearEvent (event ) 

1.2- isEventSet (event) 

1.3- setEvent (event ) 

1.4- isEventSet (event) 

1.5- clearEvent (event ) 


1.1- No exception shall be thrown. 

1.2- Shall return false. 

1 .3- No exception shall be thrown. 

1.4- Shall return true. 

1 .5- No exception shall be thrown. 




3 


Event 

Call setEvent (0) 


Shall throw a ToolkltExceptlon with 
EVENT_NOT_SUPPORTED reason 
code. 




4 


Setting EVENT_MENU_SELECTION 

Call setEvent (EVENT_MENU_SELECTION) 


Shall throw a ToolkltExceptlon with 
EVENT_NOT_ALLOWED reason 
code. 




5 


Setting 
EVENT_MENU_SELECTION_HELP_REQUEST 

Call 

setEvent (EVENT_MENU_SELECTION_HELP_REQUES 

T) 


Shall throw a ToolkltExceptlon with 
EVENT_NOT_ALLOWED reason 
code. 




6 


Setting EVENT_TIMER_EXPIRATION 

Call setEvent (EVENT_TIMER_EXPIRATION) 


Shall throw a ToolkltExceptlon with 
EVENT_NOT_ALLOWED reason 
code. 




7 


Setting EVENT_STATUS_COMMAND 


Shall throw a ToolkltExceptlon with 
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Call setEvent (EVENT_STATUS_COI«AND) 


EVENT_NOT_ALLOWED reason 
code. 




8 


Setting EVENT_CALL_CONTROL_BY_SIM 

Call setEvent (EVENT_CALL_CONTROL_BY_SIM) 


No Exception shall be thrown 




9 


Setting 

EVENT MO SHORT MESSAGE CONTROL B 

Y_SIM 

Call 

setEvent (EVENT_MO_SHORT_MESSAGE_CONTROL_B 

Y_SIM) 


No Exception shall be thrown 




10 


Check applet is triggered by an 
ENVELOPE(CALL_CONTROL_BY_SIM) 

Trigger the applet 


Applet is trigged by an 
ENVELOPE(CALL CONTROL BY 
SIM) 




11 


Check applet is triggered by an 

ENVELOPE(MO SHORT MESSAGE CONTRO 

L_BY_SIM) 

Trigger the Applet 


Applet is trigged by an 
ENVELOPE(MO SHORT MESSAG 
E_GONTROL_BY_SIM) 




12 


Applet 2 is triggered by ENVELOPE(SMS 
PP_DOWNLOAD) command. 

Trigger the applet 2 


Applet 2 is trigged by an 

ENVELOPE(SMS 

PP DOWNLOAD) command 




13 


Applet 2 registers to 
CALL_CONTROL_BY_SIM 
but it is already assigned 

setEvent (EVENT_CALL_CONTROL_BY_SIM) 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 




14 


Applet 2 registers to 

MO_MESSAGE_CONTROL_BY SIM 

but it is already assigned 

setEvent (EVENT_MO_SHORT_MESSAGE_CONTROL_B 
Y_SIM) 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 





6.2.9.12.4 



Test Coverage 



CRR number 


Test case number 


N1 


2 


N2 


1,8,9,10, 11, 12 


N3 


2,4,5,6,7 


PI 


3 


P2 


4 


P3 


5 


P4 


6 


P5 


7 


CI 


13 


C2 


14 



6.2.9.13 Method setEventList 

Test Area Reference: API_2_TKR_SEVL_BSS 



6.2.9.13.1 



Conformance Requirement: 



The method with following header shall be compliant to its definition in the API. 

public void setEventList (byte [ ] eventList, 

short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java .lang . Array IndexOut Of BoundsExcept ion, 
ToolkitException 
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Normal execution 

CRRNl: for all events set successfully by this method, a call to isEventSet() method should return true. 

CRRN2: the SIM Toolkit Framework shall trigger the applet if an occurrence of one of the successfully registered 
events happens. 

CRRN3: this method shall accept all the events defined in GSM 0319 excepted: EVENT_MENU_SELECTION, 
EVENT_MENU_SELECTION_HELP_REQUEST, EVENT_TIMER_EXPIRATION , 
EVENT_STATUS_COMMAND. 

Parameters error 

CRRPl: shall throw a java.lang.NullPointerException if eventList is null. 

CRRP2: shall throw a java.lang.ArraylndexOutOfBoundsException if offset would cause access outside array 
bounds. 

CRRP3: shall throw a java.lang.ArraylndexOutOfBoundsException if length would cause access outside array 
bounds. 

CRRP4: shall throw a java.lang.ArraylndexOutOfBoundsException if both offset and length would cause access 
outside array bounds. 

CRRP5: shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if event is 0. 

CRRP6: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_MENU_SELECTION. 

CRRP7: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP8: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_TIMER_EXPIRATION. 

CRRP9: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_STATUS_COMMAND. 

Context errors 

CRRCl: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if eventList contains 
EVENT_CALL_CONTROL_BY_SIM but another applet is already registered to it. 

CRRC2: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if eventList contains 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM but another applet is already registered to it. 



6.2.9.13.2 
Test Script: 
Test Applet: 

Load Script: 

Cleanup script: 
6.2.9.13.3 



Test suite files 
API_2_TKR_SEVL_BSS_1 .scr 

1. API_2_TKR_ SEVL_BSS _Ljava 

2. API_2_TKR_ SEVL_BSS _2.java 
API_2_TKR_ SEVL_BSS_Lldr 

The load script installs the 2 instances. 
API_2_TKR_ SEVL_BSS_Lclr 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet 1 Registering all eventList buffer 

EventList = all allowed events defined in 


1 - No exception shall be thrown. 
2- No exception shall be thrown. 
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GSM 0319: 








EVENT_PROF I LE_DOWNLOAD , 


3- Each time shall return true. 






EVENT_FORMATTED_SMS_PP_ENV, 








EVENT_FORMATTED_SMS_PP_UPD, 
EVENT_UNFORMATTED_SMS_PP_ENV, 


4- No exception shall be thrown. 






EVENT_UNFORMATTED_SMS_PP_UPD, 








EVENT_UNFORMATTED_SMS_CB, 








EVENT_CALL_CONTROL_BY_SIM, 








EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM, 








EVENT_EVENT_DOWNLOAD_MT_CALL , 








EVENT_EVENT_DOWNLOAD_CALL_CONNECTED, 








EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED, 








EVENT_EVENT_DOWNLOAD_LOCATION_STATUS, 








EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 








EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 








, EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 








1- For each event in EventList 








clearEvent (event) 








2- setEventList (eventList) 








Offset = 








Length = eventList . lentgh 








3- For all events in eventList 








isEventSet (event) 








4- For each event in EventList 








clearEvent (event) 






2 


Registering part of eventList buffer 

EventList = all allowed events defined in 
GSM 0319 (see test case 1) . 








1- For each event in EventList 


1 - No exception shall be thrown. 






clearEvent (event) 








2- setEventList (eventList, offset, 


2- No exception shall be thrown. 






length) 


3- Each time shall return true for 






Offset > 








Length = eventList . lentgh - offset 


events ranging from offset to 
offset+length else shall return false. 






3- For all events in eventList: 


4- No exception shall be thrown. 






isEventSet (event) 








4- For each event in EventList: 








clearEvent (event) 






3 


Null buffer 


Shall throw a 






EventList = null 


java.lang.NullPointerException 
Exception 




4 


Out of bounds offset 


Shall throw a 






Offset = eventList . length 


java.lang.ArraylndexOutOfBounds 






Length = 1 


Exception 




5 


Out of bounds and big offset 


Shall throw a 






Offset = 255 


java.lang.ArraylndexOutOfBounds 






Length = 1 


Exception 




6 


Offset < 


Shall throw a 






Offset = -1 


java.lang.ArraylndexOutOfBounds 






Length = 1 


Exception 




7 


Out of bounds length 


Shall throw a 






Offset = 


java.lang.ArraylndexOutOfBounds 






Length = eventList . length + 1 


Exception 
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8 


Out of bounds and big length 

Offset = 
Length = 255 


Shall throw a 

java.lang.ArraylndexOutOfBounds 

Exception 




9 


Length < 

Offset = 
Length = -1 


Shall throw a 

java.lang.ArraylndexOutOfBounds 

Exception 




10 


Out of bounds offset + Length 

Offset + length > eventList . length + 1 


Shall throw a 

java.lang.ArraylndexOutOfBounds 

Exception 




11 


Event 

Call setEventList (eventList) with 
eventList indicating event 


Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED 
reason code. 




12 


EVENT_MENU_SELECTION 

Call setEventList (eventList ) with 
eventList indicating EVENT_MENU_SELECTION 


Shall throw a ToolkitException with 
reason code 
EVENT_NOT_ALLOWED. 




13 


EVENT_MENU_SELECTION_HELP_REQUEST 

Call setEventList (eventList ) with 
eventList indicating 
EVENT_MENU_SELECTION_HELP_REQUEST 


Shall throw a ToolkitException with 
reason code 
EVENT_NOT_ALLOWED. 




14 


EVENT_TIMER_EXPIRATION 

Call setEventList (eventList ) with 
eventList indicating 
EVENT_TIMER_EXPIRATION 


Shall throw a ToolkitException with 
reason code 
EVENT_NOT_ALLOWED. 




15 


EVENT_STATUS_COMMAND 

Call setEventList (eventList) with 
eventList indicating EVENT_STATUS_COMMAND 


Shall throw a ToolkitException with 
reason code 
EVENT_NOT_ALLOWED. 




16 


Setting EVENT_CALL_CONTROL_BY_SIM 

setEventList (List, 0, 2) with List 
containing 

EVENT_CALL_CONTROL_BY_SIM S 
EVENT_MO_SHORT„MESSAGE_CONTROL„BY_SIM 


Shall not throw an exception 




17 


Check applet is triggered by an 
ENVELOPE(CALL_CONTROL_BY_SIM) 

Reset and initialise the card 
Trigger the applet 


Applet is trigged by an 
ENVELOPE{CALL CONTROL BY 
_SIM) 




18 


Check applet is triggered by an 

ENVELOPE(MO SHORT MESSAGE CONTROL 

_BY_SIM) 

Trigger the applet 


Applet is trigged by an 
ENVELOPE(MO SHORT MESSA 
GE_CONTROL_BY_SIM) 




19 


Applet 2 registers to CALL_CONTROL_BY_SIM 
but it is already assigned 

setEventList (MonoEventList, 0, 1) with 
MonoEventList containing 
EVENT_CALL_CONTROL_BY_SIM 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 




20 


Applet 2 registers to 

MO_SHORT_MESSAGE_CONTROL_BY_SIM 

but it is already assigned 

setEventList(MonoEventList,0,1 ) with 

MonoEventList containing 

EVENT MO SHORT MESSAGE CONTROL BY 

SIM 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 
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6.2.9.13.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


16,17,18 


N3 


1,2,11, 12,13,14,15 


P1 


3 


P2 


4,5,6 


P3 


7,8,9 


P4 


10 


P5 


11 


P6 


12 


P7 


13 


P8 


14 


P9 


15 


C1 


19 


C2 


20 



6.2.10 Class ViewHandler 

It is not possible to test the methods provided by this class as it is declared 'abstract'; it will be done in the class 
inheriting it: EditHandler, EnvelopeHandler, ProactiveResponseHandler, ProactiveHandler. 

6.2.1 1 Class ToolkitException 
6.2.1 1 .1 Exception Constants 

Test Area Reference: API_2_TKE_CONS 

6.2.1 1 .1 .1 Conformance requirement: 

There is no API, only constants. 

Normal execution 

CRRN 1 : The Constants of the class ToolkitException shall all have the same name and value defined in the 
GSM03.19 . 



Parameters error 




No requirements 




Context errors 




No requirements 




6.2.11.1.2 


Test suite files 


None 




6.2.11.1.3 


Test procedure 



The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.2.1 1 .2 Constructor ToolkitException 

Test Area Reference: API_2_TKE_COORS 
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6.2.11.2.1 Conformance requirement: 

The constructor with following headershall compliant to its definition in the API. 

public ToolkitException (short reason) 

Normal execution 

CRRNl: Construct a ToolkitException instance with the specified reason. 

Parameters error 
No requirements 

Context errors 
No requirements 

6.2.11.2.2 Test suite files 

No additional requirements for the GSM personalisation: 
Test Script: AP1_2_TKE _C00RS_1 .scr 

Test Applet: AP1_2_TKE _COORS_l .Java 

Load Script: AP1_2_TKE _COORS_l .Idr 

Cleanup script: AP1_2_TKE _COORS_l .ch 



6.2.11.2.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


reason = (short) 19 


ToolkitException.getReasonO = 
(short) 19 





6.2.11.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1 



6.2.11.3 Method throwit 

Test Area Reference: AP1_2_TKE_THITS 

6.2.1 1 .3.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static void throwit (short reason) 
throws ToolkitException 

Normal execution 

CRRNl: Throws the JCRE instance of the ToolkitException class with the specified reason. 
CRRN2: extends javacard.framework.CardRuntimeException 

Parameters error 
No requirements 



ETSI 



3GPP TS 11 .1 3 version 7.2.0 Release 1 998 253 

Context errors 
No requirements 

6.2.11.3.2 Test suite files 

No additional requirements for the GSM personalisation: 
Test Script: API_2_TKE_ THITS_1 .scr 

Test Applet: API_2_TKE_ THITS_1 .Java 

Load Script: API_2_TKE_ THITS_1 .Idr 

Cleanup Script: API_2_TKE_THITS_l.clr 



ETSI TS 101 955 V7.2.0 (2001-09) 



6.2.11.3.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Throws the JCRE instance of ToolkitExceptlon 
with the specified reason 


Reason = 




2 


Throws the JCRE instance of ToolkitExceptlon 
with the specified reason 


Reason = 1 




3 


Throws the JCRE Instance of ToolkitExceptlon 
with the specified reason 


Reason = 15 




4 


ToolkitExceptlon extends 
javacard.framework.CardRuntimeExceptlon 


Reason = 




5 


ToolkitExceptlon extends 
javacard.framework.CardRuntlmeExceptlon 


Reason = 1 




6 


ToolkitExceptlon extends 
javacard.framework.CardRuntlmeExceptlon 


Reason = 15 





6.2.11.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


4,5,6 



6.3 



SIM Toolkit Framework 



Test Cases for the API and Framework have no interactions and are designed to be independant. The API Test Cases in 
the present specification shall be considered as completed although no framework tests have been agreed at the present 
time. 

System Handlers management 

minimum handler availability / status / content (+ response handling) 

Applet Triggering: 

for each event test separately: 

Registration / de registration, and dynamic registration 
- triggering 

multiple applet triggering 

limitations 

busy state 
Exception hiding to the mobile. 
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Events combination. 
Proactive commands sending 
Envelope response sending 
Toolkit applets installation 
Access control 
File system state 
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Annex A (normative): 

Class and Methods AID numbering and acronyms 



A.1 Sim. access 



Class Name 


Acronyms 


Numbering on 5 bits 


SIMView 


svw 


00001 


SIMSystem 


SSY 


00010 


SIMViewException 


SVE 


00011 



A.1.1 SllVIView methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static final Constants 




000001 


short increase {byte [ ] incr, short incrOffset, byte[] 
resp, short respOffset) 


INCR_BS_BS 


000010 


void invalidate 


INVL 


000011 


void readBinary (short fileOffset, byte[] resp, short 
respOffset, short respLength) 


REDBS_BSS 


000100 


short readRecord (short recNumber, byte mode, short 
recOffset, byte[] resp, short respOffset, short 
respLength) 


REDRSBS_BSS 


000101 


void rehabilitate ( ) 


REHA 


000110 


short seek (byte mode, byte[] patt, short pattOffset, 
short pattLength) 


SEEKB_BSS 


000111 


void select (short fid) 


SLOTS 


001000 


short select (short fid, byte[] fci, short fciOffset, 
short fciLength) 


SLCTS_BSS 


001001 


short status (byte [ ] fci, short fciOffset, short 
fciLength) 


STAT_BSS 


001010 


short updateBinary (short fileOffset, byte[] data, 
short dataOffset, short dataLength) 


UPDBS_BSS 


001011 


void updateRecord (short recNumber, byte mode, short 
recOffset, byte[] data, short dataOffset, short 
dataLength) 


UPDRSBS_BSS 


001100 



A.1 .2 SllVISystem methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static SIMView getTheSIMView () 


GETS 


000001 



A.1. 3 SIMViewException methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static void throwit (short reason) 


THITS 


000001 


SIMViewException (short reason) 


COORS 


000010 


Constants 


CONS 


000011 
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A.2 Sim.too kit 


Class Name 


Acronyms 


Numbering on 5 bits 


Toolkit Con St ants 


TKC 


00001 


Toolkitlnterface 


TKI 


00010 


EditHandler 


EDH 


00011 


EnvelopeHandler 


ENH 


00100 


EnvelopeResponseHandler 


ERH 


00101 


MEProfile 


MEP 


00110 


ProactiveHandler 


PAH 


00111 


ProactiveResponseHandler 


PRH 


01000 


ToolkitRegistry 


TKR 


01001 


ViewHandler 


VWH 


01010 


Toolkit Except ion 


TKE 


01011 



A.2.1 ToolkitConstants 



Method Name 


Acronyms 


Numbering on 6 bits 


Constants 


CONS 


000001 



A.2. 2 Toolkitlnterface methods 



Method Name 


Acronyms 


Numbering on 6 bits 


void processToolkit (byte event) 


PRTKB 


000001 



A.2.3 EditHandler methods 

The numbering of the EditHandler methods it will be done in the classes inherit it: EnvelopeResponseHandler, 
ProactiveHandler, because the methods provided by this class as it is declared 'abstract'. 



A.2. 4 EnvelopeHandler methods 



Method Name 


Acronyms 


Numbering on 6 bits 


byte getEnvelopeTag ( ) 


GENT 


000001 


byte get Itemldentif ier ( ) 


GIID 


000010 


short getSecuredDataLength ( ) 


GSDL 


000011 


short getSecuredDataOf f set ( ) 


GSDO 


000100 


EnvelopeHandler getTheHandler ( ) 


GTHD 


000101 


short getTPUDLOffset 


GTPO 


000110 








Inherited Method Name: ViewHandler 






Byte 

compareValue (short valueOff set, byte [ ] compareBuf fer, 

short compareOf f set , short compareLength) 


CPRVS_BSS 


0001 1 1 


Short 

copy (byte [] dstBuf fer, short dstOff set, short dstLengt 

h) 


GOPY_BSS 


001000 


Short 

copyValue (short valueOffset, 

byte[] dstBuf fer, short dstOff set, short dstLength) 


CPYVS_BSS 


001001 


Byte 
f indAndCompareValue (byte tag, byte [] compareBuf fer, sh 
ort compareOf f set ) 


FACRB_BS 


001010 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOff set, byte [ ] compareBuf fer, short compare 
Offset, short compareLength) 


FAGRBBS_BSS 


001011 


Short 
FindAndCopyValue (byte tag, byte occurence, short value 


FAGYBBS_BSS 


001100 
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Offset, byte[] dstBuffer, short dstOffset, 
short dstLength) 






Short 
f indAndCopyValue (byte tag, byte [] dstBuffer, short dst 
Offset) 


FACYB_BS 


001101 


Byte 

FindTLV (byte tag, byte occurrence) 


FINDBB 


001110 


Short 
GetLengthO 


GLEN 


001111 


Byte 
GetValueByte (short valueOffset) 


GVBYS 


010000 


Short 
GetValueLengthO 


GVLE 


010001 



A.2.5 EnvelopeResponseHandler methods 



Method Name 


Acronym 


Numbering on 6 bits 


EnvelopeResponseHandler getTheHandler ( ) 


GTHD 


000001 


Void post (byte statusType) 


POSTS 


000010 


Void postAsBERTLV (byte statusType, byte tag) 


POSTBB 


000011 








Inherited Method Name: EditHandler 






Void appendArray (byte [ ] buffer, short offset, short 
length, short dstLength) 


APDA 


000100 


Void appendTLV (byte tag, byte value) 


APTLBB 


000101 


Void appendTLV (byte tag, byte[] value, short 
valueOffset, short valueLength) 


APTLB_BSS 


000110 


Void appendTLV (byte tag, byte valuel, byte value2) 


APTLBBB 


000111 


Void appendTLV (byte tag, byte valuel, byte[] value2, 
short value20f f set, short value2Length) 


APTLBB_BSS 


001000 


Void clear 


CLER 


001001 








Inherited Method Name: ViewHandler 






Byte 

compareValue (short valueOff set, byte [ ] compareBuf fer, 

short compareOf f set , short compareLength) 


GPRVS_BSS 


001010 


Short 

Copy (byte [] dstBuffer, short dstOffset, short dstLengt 

h) 


GOPY_BSS 


001011 


Short 

CopyValue (short valueOffset, 

byte[] dstBuffer, short dstOffset, short dstLength) 


CPYVS_BSS 


001100 


Byte 
FindAndCompareValue (byte tag, byte [] compareBuf fer, sh 
ort compareOf f set ) 


FACRB_BS 


001101 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOff set, byte [ ] compareBuf fer, short compare 
Offset, short compareLength) 


FACRBBS_BSS 


001110 


Short 
FindAndCopyValue (byte tag, byte occurence, short value 
Offset, byte[] dstBuffer, short dstOffset, 
short dstLength) 


FACYBBS_BSS 


001111 


Short 
f IndAndCopyValue (byte tag, byte [] dstBuffer, short dst 
Offset) 


FACYB_BS 


010000 


Byte 

FindTLV (byte tag, byte occurrence) 


FINDBB 


010001 


Short 
GetLengthO 


GLEN 


010010 


Byte 
GetValueByte (short valueOffset) 


GVBYS 


010011 


Short 
GetValueLengthO 


GVLE 


010100 
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A.2.6 MEProfile methods 



Method Name 


Acronym 


Numbering on 6 bits 


static boolean check (byte index) 


CHECB 


000001 


Static boolean check (byte [] mask, short offset, short 
length) 


CHECBSS 


000010 



A.2.7 ProactiveHandler methods 



IVIethod Name 


Acronyms 


Numbering on 6 bits 


GetTheHandler 


GTHD 


000001 


Init (byte type, byte qualifier, byte dstDevice) 


INITBBB 


000010 


InitDisplayText (byte qualifier, byte dcs, byte[] 
buffer, short offset, short length) 


INDTBB_BSS 


000011 


InitGet Inkey (byte qualifier, byte dcs, byte[] buffer, 
short offset, short length) 


INGKBB_BSS 


000100 


InitGet Input (byte qualifier, byte dcs, byte[] buffer, 
short offset, short length, short minRespLength, 
short maxRespLength) 


INGPBB_BSSSS 


000101 


Byte sendO 


SEND 


000110 








Inherited Method Name: EditHandler 






Void appendArray (byte [ ] buffer, short offset, short 
length, short dstLength) 


APDA 


000111 


Void appendTLV (byte tag, byte value) 


APTLBB 


001000 


Void appendTLV (byte tag, byte[] value, short 
valueOffset, short valueLength) 


APTLB_BSS 


001001 


Void appendTLV (byte tag, byte valuel, byte value2) 


APTLBBB 


001010 


Void appendTLV (byte tag, byte valuel, byte[] value2, 
short value20f f set , short value2Length) 


APTLBB_BSS 


001011 


Void clear ( ) 


CLER 


001100 








Inherited Method Name: ViewHandler 






Byte 

CompareValue (short valueOffset, byte [ ] compareBuf fer, s 

hort compareOf f set, short compareLength) 


GPRVS_BSS 


001101 


Short 

Copy (byte [] dstBuf fer, short dstOff set, short dstLength 

) 


GOPY_BSS 


001110 


Short 

CopyValue (short valueOffset, 

byte[] dstBuf fer, short dstOff set, short dstLength) 


GPYVS_BSS 


001111 


Byte 
FindAndCompareValue (byte tag, byte [] compareBuf fer, sho 
rt compareOf f set ) 


FAGRB_BS 


010000 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOffset, byte [ ] compareBuf fer, short compareO 
ffset, short compareLength) 


FAGRBBS_BSS 


010001 


Short 
FindAndCopyValue (byte tag, byte occurence, short valueO 
ffset, byte[] dstBuf fer, short dstOff set, 
short dstLength) 


FAGYBBS_BSS 


010010 


Short 
f indAndCopyValue (byte tag, byte [] dstBuf fer, short dstO 
ffset) 


FAGYB_BS 


010011 


Byte 

FindTLV (byte tag, byte occurrence) 


FINDBB 


010100 


Short 
GetLengthO 


GLEN 


010101 


Byte 
GetValueByte (short valueOffset) 


GVBYS 


010110 


Short 
GetValueLengthO 


GVLE 


010111 
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A.2.8 ProactiveResponseHandler methods 



Method Name 


Acronyms 


Numbering on 6 bits 


Short CopyAdditionallnformation (byte [ ] dstBuffer, 
short dstOffset, short dstLength) 


CPALBSS 


000001 


Short copyTextString (byte [] dstBuffer, short 
dstOffset) 


CPTS_BS 


000010 


Short getAdditionalInf ormationLength ( ) 


GTIL 


000011 


Byte getGeneralResult ( ) 


GTGR 


000100 


Byte getltemldentif ier ( ) 


GTII 


000101 


Byte getTextStringCodingScheme ( ) 


GTCS 


000110 


Short getTextStringLength 


GTTL 


000111 


GetTheHandler 


GTHD 


001000 








Inherited Method Name: ViewHandler 






Byte 

CompareValue (short valueOff set, byte [ ] compareBuf fer, s 

hort compareOf f set , short compareLength) 


CPRVS_BSS 


001001 


Short 

Copy (byte [] dstBuffer, short dstOffset, short dstLength 

) 


COPY_BSS 


001010 


Short 

CopyValue (short valueOffset, 

byte[] dstBuffer, short dstOffset, short dstLength) 


CPYVS_BSS 


001011 


Byte 
FindAndCompareValue (byte tag, byte [] compareBuf fer, sho 
rt compareOf f set ) 


FACRB_BS 


001100 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOff set, byte [ ] compareBuf fer, short compareO 
ff set, short compareLength) 


FACRBBS_BSS 


001101 


Short 
FindAndCopyValue (byte tag, byte occurence, short valueO 
ffset, byte[] dstBuffer, short dstOffset, 
short dstLength) 


FACYBBS_BSS 


001110 


Short 
f indAndCopyValue (byte tag, byte [] dstBuffer, short dstO 
ffset) 


FAGYB_BS 


001111 


Byte 

FindTLV(byte tag, byte occurrence) 


FINDBB 


010000 


Short 
GetLengthO 


GLEN 


010001 


Byte 
GetValueByte (short valueOffset) 


GVBYS 


010010 


Short 
GetValueLengthO 


GVLE 


010011 
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A.2.9 ToolkitRegistry methods 



Method Name 


Acronyms 


Numbering on 6 bits 


AllocateTimer () 


ATIM 


000001 


changeMenuEntry (byte id, byte [ ] menuEntry, short 
offset, short length, byte nextAction, boolean 
helpSupported, byte IconQualif ier, short 
iconldentif ier ) 


CMETB_BSSBZBS 


000010 


clearEvent (byte event) 


CEVTB 


000011 


disableMenuEntry (byte id) 


DMETB 


000100 


enableMenuEntry (byte id) 


EMETB 


000101 


getEntry () 


GETY 


000110 


getPollInterval () 


GPOL 


000111 


initMenuEntry (byte [ ] menuEntry, short offset, short 
length, byte nextAction, boolean helpSupported, byte 
iconQualif ier, short iconldentif ier) 


IMET_BSSBZBS 


001000 


isEventSet (byte event) 


lEVSB 


001001 


releaseTimer (byte timerldentif ier ) 


RTIM 


001010 


requestPollInterval (short duration) 


RPOL 


001011 


setEvent (byte event) 


SEVTB 


001100 


setEventList (byte [ ] eventList, short offset, short 
length) 


SEVL BSS 


001101 



A.2.10 ViewHandler methods 

The numbering of the ViewHandler methods it will be done in the classes inherit it: EditHandler, EnvelopeHandler, 
ProactiveResponseHandler, ProactiveHandler, because the methods provided by this class as it is declared 'abstract'. 

A.2.11 ToolkitException methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static void throwit (short reason) 


THITS 


000001 


ToolkitException (short reason) 


GOORS 


000010 


Constants 


CONS 


00001 1 
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Annex B (normative): 

Script file syntax and format description 

CMD : Command to follow 

RST ; Resets and powers on the card 

OFF ; Powers off the card 

INI ; Performs the terminal profile with the following data. Afterwards, it shall perform all the 

fetch and terminal response commands until there is no proactive session in progress. 

REM ; Used for comments 

'\n'; Empty lines are accepted 

' ' , ' \t ' : Can be used as separator 

' \ ' : Continues on next line 

XXX : each line beginning with 3 characters indicates other tool command. 

[...] data to be checked, need to be present for an outgoing command. Bytes written as XX shall not be 
checked by the APDU tool. 

(...) status to be checked; when several status are valid they shall be separated by commas. Bytes 
written as XX shall not be checked by the APDU tool. 

REM this is an example 

RST 

INI FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

REM Case 1 example 

CMD AO C2 00 00 00 (91 33 , 69 XX) 

REM Case 2 example 
CMD AO C2 00 00 BO \ 

[XX XX XX 55 55 XX 55] (91 33 , 69 XX) 
CMD AO C2 00 00 BO [] (91 33 , 69 XX) 

CMD AO CO IF \ 

[10 AO 00 00 00 09 00 02 FF FF FF FF 89 28 A4 05 \ 
02 OD CC CC CC CC CC CC CC CC CC CC CC CC CC ] \ 
(90 00) 

REM Case 3 example 

CMD AO C2 00 00 33 \ 

Dl 31 82 02 83 81 06 05 80 11 22 33 44 8B 24 40 \ 

08 00 24 23 85 18 41 04 51 10 10 00 00 00 00 13 \ 

02 70 00 00 OE OD 00 00 00 00 28 A4 05 00 00 00 \ 

00 00 00 \ 

(90 00) 

OFF 

In order to show a common appearance all the scripts shall follow those format rules: 

- start always with a 'RST' followed by an 'INI' command. 

- The command, data to be checked and status to be checked shall be presented in the following order: 
CMD COMMAND [EXPECTED DATA] (EXPECTED STATUS) 

- APDU shall be presented with command (CLA INS PI P2 P3) in one line and data (if present) in next line 
grouped 16 bytes per line (see example above). 

- The expected data (if present) shall be presented in 16 bytes groups per line (see example above). 



£75/ 



3GPP TS 11.13 version 7.2.0 Release 1998 



262 



ETSI TS 101 955 V7.2.0 (2001-09) 



Annex C (normative): 
Default Prepersonalisation 

C.1 General Default Prepersonalisation 

This table shows the defauh prepersonalisation, the file system and the files' content, that the test SIM cards shall 
contain unless otherwise stated. 



Name 


Identifier 


Default Value 


Special Features 


EFicciD 


2FE2 


OF FF FF FF FF FF FF FF FF FF 


This value is not compliant with GSM 11.11 


EFiMsi 


6F07 


FF FF FF FF FF FF FF FF FF 


This value is not compliant with GSM 11.11 


EFlp 


6F05 


01 FF FF FF 




EFkc 


6F20 


FF FF FF FF FF FF FF FF 07 




EFpLMNsel 


6F30 


FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF FF 




EFhplmn 


6F31 


05 




EFACMmax 


6F37 


00 00 00 


Access condition UPDATE: CHV1 


EFssT 


6F38 


FF 3F C3 03 OC 00 FF OF 00 33 




EFacm 


6F39 


00 00 00 


Access condition UPDATE: CHV1 


EFpucT 


6F41 


FF FF FF 00 00 


Access condition UPDATE: CHV1 


EFbcch 


6F74 


FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF 




EFacc 


6F78 


00 00 




EFppLMN 


6F7B 


FF FF FF FF FF FF FF FF FF FF FF FF 




EFloci 


6F7E 


FF FF FF FF 00 FO 00 00 00 FF 01 




EFad 


6FAD 


00 FF FF 




EFphase 


6FAE 


03 




EFpDN 


6F3B 


Default value in all the records: 

FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF 


Records: 5 


EFsMSP 


6F42 


FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF 


Records: 1 


EFlnd 


6F44 


FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF 


Records: 1 


EFsMss 


6F43 


FF FF 




EFsMs 


6F3C 


1=' record: 00 FF ... FF (length 176) 
2"'* record: 00 FF ... FF (length 176) 
3"* record: 00 FF ... FF (length 176) 


Records: 3 


EFadn 


6F3A 


FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF 


Records: 1 


EFccp 


6F3D 


FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF 




EFmsisdn 


6F40 


FF FF FF FF FF FF FF FF FF FF FF FF 

FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF 


Records: 1 


EFsDN 


6F41 


FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF 


Records: 1 


EFsUME 


6F54 


85 OC 54 4F 4F 4C 4B 49 54 20 54 45 

53 54 FF FF FF FF 




EFcBMi 


6F45 


FF FF 




EFiM 


4F20 


FF FF FF FF FF FF FF FF FF FF FF 





The default value for the CHVl shall be "0x31 0x31 0x31 0x31 OxFF OxFF OxFF OxFF" and its state shall be 'disabled' 
during test applets execution. 
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C.2 Sim.Access.SimView test default prepersonalisation 
C.2.1 DFsiMTEST (SIM Test) 

Identifier: '0319' 

C.2. 2 EFtnr (Transparent Never Read) 



Identifier: '6F01' Structure: transparent 


IVIandatory 


File size: 3 bytes Update activity: low 


Access Conditions: 

READ NEVER 

UPDATE ALWAYS 

INVALIDATE ALWAYS 

REHABILITATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1-3 


Test Data 


AA AA AA 


M 


3 bytes 



C.2. 3 EFjNu (Transparent Never Update) 



Identifier: '6F02' Structure: transparent 


IVIandatory 


File size: 3 bytes Update activity: low 


Access Conditions: 

READ ALWAYS 

UPDATE NEVER 

INVALIDATE ALWAYS 

REHABILITATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 -3 


Test Data 


55 55 55 


M 


3 bytes 



C.2. 4 EFtaru (Transparent Always Read and Update) 



Identifier: '6F03' Structure: transparent IVIandatory 


File size: 260 bytes Update activity: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INVALIDATE ALWAYS 
REHABILITATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 -260 


Test Data 


FF... FF 


M 


260 
bytes 
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C.2.5 EFcNR (Cyclic Never Read) 



Identifier: '6F04' Structure: cyclic 


Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
READ NEVER 
UPDATE ALWAYS 
INCREASE ALWAYS 
INVALIDATE ALWAYS 
REHABILITATE ALWAYS 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GO GO 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



C.2.6 EFcNu (Cyclic Never Update) 



Identifier: '6FG5' Structure: cyclic 


Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 

READ ALWAYS 

UPDATE NEVER 

INCREASE NEVER 

INVALIDATE ALWAYS 

REHABILITATE ALWAYS 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GG GG 


M 


3 bytes 


3 


Test Data 


00 GG GG 


M 


3 bytes 



C.2.7 EFcNic (Cyclic Never Increase) 



Identifier: '6F06 Structure: cyclic 


Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INCREASE NEVER 
INVALIDATE ALWAYS 
REHABILITATE ALWAYS 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GG GG 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 
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C.2.8 EFcNiv (Cyclic Never Invalidate) 



Identifier: '6F07 Structure: cyclic 


IVlandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INCREASE ALWAYS 
INVALIDATE NEVER 
REHABILITATE ALWAYS 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GO GO 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



C.2.9 EFcNRH (Cyclic Never Rehabilitate) 



Identifier: '6FG8' Structure: cyclic 


IVlandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INCREASE ALWAYS 
INVALIDATE ALWAYS 
REHABILITATE NEVER 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GG GG 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



C.2.10 EFcARu (Cyclic Always Read and Update) 



Identifier: '6FG9' Structure: cyclic 


Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INCREASE ALWAYS 
INVALIDATE ALWAYS 
REHABILITATE ALWAYS 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


55 55 55 


M 


3 bytes 


2 


Test Data 


AA AA AA 


M 


3 bytes 
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C.2.1 1 EFlnr (Linear Fixed Never Read) 





Identifier: '6F0A' 


Structure: linear fixed IVIandatory 




Record length: 4 bytes 


Update activity: low 


Access Conditions: 

READ NEVER 

UPDATE ALWAYS 

INVALIDATE ALWAYS 

REHABILITATE ALWAYS 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data - Record 1 


FF FF FF FF 


M 


4 bytes 


2 


Test Data - Record 2 


FF FF FF FF 


M 


4 bytes 



C.2.1 2 EFlnu (Linear Fixed Never Update) 





Identifier: '6F0B' 


Structure: linear fixed Mandatory 




Record length: 4 bytes 


Update activity: low 


Access Conditions: 

READ ALWAYS 

UPDATE NEVER 

INVALIDATE ALWAYS 

REHABILITATE ALWAYS 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data - Record 1 


FFFFFFFF 


M 


4 bytes 


2 


Test Data - Record 2 


FF FF FF FF 


M 


4 bytes 



C.2.1 3 EFlaru (Linear Fixed Always Read and Update) 





Identifier: '6F0C' 


Structure: linear fixed Mandatory 


Record length: 4 bytes 


Update activity: low 




Acces 
READ 
UPDATE 
INVALIDATE 
REHABILITA 


s Conditions: 

ALWAYS 
ALWAYS 
ALWAYS 

TE ALWAYS 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data - Record 1 


55 55 55 55 


M 


4 bytes 


2 


Test Data - Record 2 


AA AA AA AA 


M 


4 bytes 
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C.2.14EFciNA (Cyclic Increase Not Allowed) 



Identifier: '6F0D' Structure: cyclic IVlandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INCREASE ALWAYS (see note 1 ) 
INVALIDATE ALWAYS 
REHABILITATE ALWAYS 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 


Note 1 : This file will be personalised in a way such that increase is not allowed, as indicated by the 
FCI byte 8, bit 7 (GSIV1 1 1 .11 : FCI structure of an EF returned by the SELECT command) 
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Annex D (normative): 

sim.test.util package and loading , testing and cleaning 

script examples. 

See attached files: 

Annex_D_SimTestUtil.zip 
Annex_D_Examples.zip 
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Annex E (normative): 
Test Area files. 

See attached file: 

Annex_E_SourceCode.zip 
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Annex F (informative): 
Change history 



The table below indicates all changes that have been made to the present document since drafting work began. 



Change history | 


Date 


TSG# 


TSG Doc 


CR 


Rev 


Cat 


Subject/Comment 


Old 


New 


2000-10 


- 










Draft presented at T3#1 6 




0.2.0 


2000-12 


TP-10 


TP-000208 








Presented to TSG-T #10 for information 


0.2.0 


1.0.0 


2001-01 


- 


- 








Input to T3 #17 resulting from T3 ad hoc #24 


1.0.0 


1.1.0 


2001-03 


- 










Document presented for approval at T3#1 8 


1.1.0 


1.2.0 


2001-03 


TP-11 


TP-010041 








Doument presented for approval to TSG-T #1 1 (identical 
in technical content to v1 .2.0) 


1.2.0 


2.0.0 


2001-03 












As approved at TSG-T #1 1 (identical in technical content 
tov2.0.0) 


2.0.0 


7.0.0 


2001-05 












Correction to date on cover page / headers 


7.0.0 


7.0.1 


2001-06 


TP-12 


TP-010105 


A001 




F 


Corrections to the API Test plan, addition of the test area 
files and modification of the util package 


7.0.1 


7.1.0 


2001-09 


TP-13 


TP-010206 


A002 




F 


Update API Test plan and Test Area Files 


7.1.0 


7.2.0 
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